Live Case Lookup API
API To Look Up Any Indian Court Case By CNR Or Case Number, And Summarize It With AI
The Live Case Lookup API retrieves the details of a single case in an Indian court or tribunal on demand, using its CNR or case number. Built for due diligence, onboarding and contract review, it answers the moment a name or a case comes up, without adding anything to a watchlist.
The response includes the parties, court, stage, filing date and every order on the case. Each order carries an orderId you can use to download that order's document, and the lookup returns a searchId you can use to download every order as one zip, or to request an AI summary: a plain-language summary of the case with a risk level and the reasoning behind it.
Built on certified infrastructure
CasePrimus.ai is operated by Pegadroid IQ Solutions Private Limited, the legal entity behind Attestr's products, which holds ISO/IEC 27001:2022 certification. Data is hosted in India (AWS Mumbai, ap-south-1) and every connection is encrypted in transit. See Trust & Compliance.
Key capabilities
Lookup by CNR or case number
Send the cnr where you have it. For other cases, identify the case by court type, registration number, case type and bench or tribunal code.
All major courts and tribunals
District Courts, High Courts, the Supreme Court, Consumer Commissions, and the NCLT, NCLAT, GSTAT, DRT, DRAT, CESTAT, NGT, SAT, ITAT and APTEL tribunals.
Full case details
Parties, court, stage, filing date and every order on the case, in one response.
Order documents on demand
Download any order's document through a signed link that expires after 5 minutes. Each page carries a CasePrimus provenance strip, and the document is not a certified copy.
All orders as one zip
Download every order of a case as a single zip: start the bundle, then poll it until it is ready.
An AI summary in plain language
Request a summary of the case, with a risk level, the reasoning behind it, and a summary of every order.
No watchlist needed
A lookup is one-time and on demand. It starts no monitoring and needs no party.
Refresh on demand
Looking up the same case again refreshes it and returns the same searchId.
How it works
- 1
Send the case identifier
Post a
caseIdentifierwith the court type and the CNR or case number toPOST /case-lookup. - 2
Receive the case
You get the parties, court, stage, filing date and orders, plus a
searchIdand anorderIdfor every order. - 3
Download the orders
Use the
searchIdand anorderIdto download an order's document, or thesearchIdalone to download every order as one zip. - 4
Ask for an AI summary
Send the
searchIdtoPOST /case-lookup/summarize, then pollGET /case-lookup/summarize/{id}until the status isCOMPLETE.
API definition
Look up a case by its identifier
Looks up a single case once, on demand, by its case number or CNR. It is not tied to a watchlist entity and starts no monitoring. The identifier fields you must send depend on courtType. Every order on the case comes back with an orderId: pass it to the order download endpoint to get that order's document. The response also carries a searchId, which you use to download orders or request an AI summary without repeating the lookup, and latestSummary, the most recent AI summary generated for the case (null if there is none). An order's attachment is always null in this response: the document comes from the order download endpoint. Looking up the same case again refreshes it and returns the same searchId. If the court has no such case you get 404 CASE_NOT_FOUND_AT_COURT and nothing is charged; if the reference matches more than one case you get 400 with code 4003. Requires case.write.
Request URL
https://api.caseprimus.ai/api/caseprimus/v1/case-lookupRequest headers
| Type | Name | Value / description | Optional |
|---|---|---|---|
| String | Content-Type | application/json | Required |
| String | X-CasePrimus-Api-Key | Your API key: {apiKey} | Required |
No API key yet? See Authentication.
Input parameters
| Field | Description |
|---|---|
caseIdentifierobject Required | Identifies one case. Which other fields you send depends on courtType - send exactly one of the alternatives listed for it. DC: cnr. SC: cnr, or caseType + registrationNumber, or diaryNumber. HC: cnr, or establishmentCode + caseType + registrationNumber. CC (consumer commission): registrationNumber (the e-Jagriti case number) only. NCLT, NCLAT, GSTAT: establishmentCode + filingNumber, or establishmentCode + caseType + registrationNumber. DRT, DRAT: establishmentCode + diaryNumber, or establishmentCode + caseType + registrationNumber. CESTAT: establishmentCode + diaryNumber, or establishmentCode + caseType + registrationNumber. NGT: establishmentCode (PB, EZ, CZ, WZ or SZ) + either caseType (OA, RA, MA, AP, EA, IA or TA) + registrationNumber (n/yyyy), or diaryNumber (the 12-digit diary number / year). SAT: establishmentCode (MUM) + either caseType (SEBI, IRDAI or PFRDA) + registrationNumber (the Appeal No., n/yyyy, at most 4 digits before the year), or filingNumber (the AL No. - Appeal Lodging number, n/yyyy). ITAT: establishmentCode (the bench's city in capitals, for example DELHI, MUMBAI or BANGALORE; Cochin is ERNAKULAM and Visakhapatnam is VISHAKHAPATNAM) + caseType (ITA, CO, ITSSA, ITTPA, ITITA, WTA, BMA, GTA, SA or MA) + registrationNumber (the Appeal No. and filing year, n/yyyy, at most 5 digits before the year); all three are required. APTEL: establishmentCode (DEL) + either caseType (APL, OP, EP, RP or CP) + registrationNumber (the Case No., n/yyyy), or diaryNumber (the DFR No., n/yyyy). The DFR number is the tribunal's diary number and every case has one from the day it is filed; a Case No. is allotted only on registration, so a recently filed case may be reachable by its DFR number alone. Note that the year means different things on the two: with a Case No. it is the year the case was registered, with a DFR No. the year it was filed, and for the same case these can differ. |
courtTypeenum Required | DCSCHCCCNCLTNCLATGSTATDRTDRATCESTATNGTSATITATAPTEL |
cnrstring Optional | DC, SC, HC only. |
registrationNumberstring Optional | Format depends on courtType - see the description above. Usually number/year (for example 87/2018; at most 4 digits for SAT, 5 for ITAT); for HC the number/year is sent with caseType, and for CC it is the whole e-Jagriti case number. |
filingNumberstring Optional | NCLT/NCLAT/GSTAT only, and SAT (the AL No. - Appeal Lodging number - n/yyyy). |
diaryNumberstring Optional | SC, DRT, DRAT, CESTAT, NGT (the 12-digit diary number / year, e.g. 070111601768/2026) and APTEL (the DFR No., n/yyyy). |
establishmentCodestring Optional | Bench/tribunal code - required for HC (when not using cnr) and every tribunal court type. NGT: PB, EZ, CZ, WZ or SZ. SAT: MUM. APTEL: DEL. ITAT: the bench's city in capitals (DELHI, MUMBAI, BANGALORE ...; Cochin is ERNAKULAM, Visakhapatnam is VISHAKHAPATNAM). |
caseTypestring Optional | Required alongside registrationNumber for most court types. The valid values depend on courtType, for example NGT: OA, RA, MA, AP, EA, IA, TA; SAT: SEBI, IRDAI, PFRDA; APTEL: APL, OP, EP, RP, CP; ITAT: ITA, CO, ITSSA, ITTPA, ITITA, WTA, BMA, GTA, SA, MA. |
Sample request
BASE="https://api.caseprimus.ai/api/caseprimus/v1" curl -X POST "$BASE/case-lookup" \ -H "X-CasePrimus-Api-Key: $CASEPRIMUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "caseIdentifier": { "courtType": "DC", "cnr": "HRFB010051662020" } }'
const BASE = "https://api.caseprimus.ai/api/caseprimus/v1"; const res = await fetch(BASE + "/case-lookup", { method: "POST", headers: { "Content-Type": "application/json", "X-CasePrimus-Api-Key": process.env.CASEPRIMUS_API_KEY, }, body: JSON.stringify({ "caseIdentifier": { "courtType": "DC", "cnr": "HRFB010051662020" } }), }); const data = await res.json();
import os import requests BASE = "https://api.caseprimus.ai/api/caseprimus/v1" res = requests.request( "POST", BASE + "/case-lookup", headers={"X-CasePrimus-Api-Key": os.environ["CASEPRIMUS_API_KEY"]}, json={ "caseIdentifier": { "courtType": "DC", "cnr": "HRFB010051662020", }, }, ) data = res.json()
Responses
| 200 | Case details found. The same shape for every court type (a common core plus a few court-specific fields), with a top-level searchId, latestSummary (nullable) and an orderId on every order. |
| 400 | Malformed caseIdentifier for the given courtType (60001, or the court's own code such as 4006 for a malformed CNR), or the reference matches more than one case (code 4003, nothing is stored or charged - make the identifier more specific). |
| 403 | Caller lacks the case.write permission, or a free-trial account has used its lookup allowance (FREE_PLAN_USAGE_LIMIT_EXCEEDED, 61443). |
| 404 | The court has no case for this reference (CASE_NOT_FOUND_AT_COURT, 60438). Nothing is stored and nothing is charged. |
| 500 | The case lookup failed at the court or in transit (CASE_LOOKUP_FAILED, 60406). Try again shortly. |
Response fields (HTTP 200)
| Field | Description |
|---|---|
searchIdstring | The id of this stored lookup. Use it to download orders, request an AI summary, or read the case back later without a new lookup. |
latestSummaryobject | The most recent AI summary generated for a case (see POST /case-lookup/summarize). A refresh of the case does not clear it. |
_idstring | The id of the summary request. |
statusenum | PENDINGCOMPLETEFAILED |
riskLevelenum or null | VERY_HIGHHIGHMODERATELOWUNCLASSIFIED |
caseSummarystring or null | |
riskJustificationstring or null | |
orderSummariesarray of object | |
errorstring or null | |
generatedAtinteger | Epoch ms when this summary was requested. |
caseTypestring or null | The case type as the court names it (for example APP - APPLICATION, Appeal, Income Tax Appeal). |
filingNumberstring or null | |
filingDatestring or null | |
filingYearstring or null | Four-digit year, as a string. |
registrationNumberstring or null | |
registrationDatestring or null | |
cnrNumberstring or null | Null when the court has no CNR or it is not exposed (for example consumer commissions, NGT, SAT, ITAT and APTEL). |
statestring or null | |
districtstring or null | |
courtNamestring or null | |
courtNumberAndJudgestring or null | |
courtEstablishmentstring or null | The court establishment (District Court) or the bench / establishment code (tribunals, for example PB, MUM, DELHI). |
firstHearingDatestring or null | |
nextHearingDatestring or null | |
previousHearingDatestring or null | |
caseStagestring or null | |
decisionDatestring or null | |
natureOfDisposalstring or null | |
caseStatusstring or null | As the court writes it: District Court says for example Case Disposed; NGT, SAT and ITAT give PENDING or DISPOSED. APTEL gives PENDING or DISPOSED, and also Defective - a filing on its DFR register whose papers the registry has not accepted, which is neither pending nor disposed. |
coramstring or null | |
judicialstring or null | |
causeListNamestring or null | |
benchstring or null | |
shortOrderstring or null | |
petitionersarray of object or null | |
petitionerNamestring | |
petitionerCounselstring or null | |
petitionerAddressstring or null | Tribunals only (NGT, SAT, ITAT, CESTAT); absent for other courts, and always null for APTEL, which publishes no party addresses. |
petitionersTextstring or null | The petitioners as one line of text (District Court: the court's own multi-line list). |
respondentsarray of object or null | |
respondentNamestring | |
respondentCounselstring or null | |
respondentAddressstring or null | Tribunals only (NGT, SAT, ITAT, CESTAT); absent for other courts, and always null for APTEL, which publishes no party addresses. |
respondentsTextstring or null | |
actsarray of object or null | |
actstring | |
sectionsstring or null | |
interlocutoryApplicationDetailsarray of object or null | Interlocutory applications. District Court gives number, party, filingDate, nextDate, status and particulars; tribunals give number, caseNumber, party, filingDate, nextDate, status, particulars and (as the court provides them) filingNumber or disposalDate. |
numberstring or null | |
caseNumberstring or null | |
partystring or null | |
filingDatestring or null | |
nextDatestring or null | |
statusstring or null | |
particularsstring or null | |
filingNumberstring or null | |
disposalDatestring or null | |
caseHistoryarray of object or null | The hearing history, newest first for tribunals. |
regany | District Court: the registration number of the case at that hearing (a string). Tribunals: the entry's position (an integer, 0 for the latest). |
causeListTypestring or null | |
judgestring or null | |
purposestring or null | |
nextHearingDatestring or null | |
businessDatestring or null | |
businessDescriptionstring or null | Tribunals only. |
adjournmentReasonstring or null | Tribunals only. |
ordersarray of object | |
numberstring or null | The order's number or reference as the court gives it. |
orderDatestring or null | As the court writes it, usually DD-MM-YYYY. |
judgestring or null | |
attachmentstring or null | Always null on a lookup: the court's own link is never exposed - use POST /case-lookup/orders/download. Reading the stored case back returns a short-lived download link here (valid for 300 seconds), only for an order you already downloaded. |
orderTypestring or null | |
resultstring or null | ITAT only: the outcome recorded for the order (for example Dismissed). Absent for other courts. |
orderIdstring | Stable for this stored lookup. Pass it, with the searchId, to POST /case-lookup/orders/download. |
downloadedAtinteger or null | Epoch ms when the order's document was first downloaded. Null for an order not downloaded yet, and always null on POST /case-lookup. |
objectionsarray of object or null | Filing objections raised by the registry, where the court publishes them (null otherwise). |
numberstring or null | |
objectionstring or null | |
scrutinyDatestring or null | |
complianceDatestring or null | |
receiptDatestring or null | |
categorystring or null | District Court only. |
subCategorystring or null | District Court only. |
subSubCategorystring or null | District Court only. |
firobject or null | District Court only: the FIR the case arises from, when it has one. |
statestring or null | |
districtstring or null | |
policeStationstring or null | |
numberstring or null | |
yearstring or null | |
earlierCourtsarray of object or null | District Court only: the lower court the case came from. |
courtNumberAndNamestring or null | |
caseNumberAndYearstring or null | |
statestring or null | |
districtstring or null | |
documentsarray of object or null | District Court only: documents filed in the case. |
docNumberstring or null | |
docNamestring or null | |
advocatestring or null | |
receivingDatestring or null | |
filedBystring or null | |
linkedCasesarray of object or null | District Court only: cases linked to this one. |
filingNumberstring or null | |
caseNumberstring or null | |
petitionerstring or null | |
respondentstring or null | |
statusstring or null | |
statusDescriptionstring or null | |
transfersarray of object or null | District Court only: transfers between courts (an empty array if there are none). Absent or null for other courts. |
regstring or null | |
transferredstring or null | |
fromstring or null | |
tostring or null | |
impugnTypestring or null | Tribunals only: the type of the order appealed against. Absent for other courts. |
impugnNumberstring or null | Tribunals only: the number of the order appealed against. |
impugnDatestring or null | Tribunals only: the date of the order appealed against. |
partyNamestring or null | NGT only: the case title (the parties as one line). |
assessmentYearstring or null | ITAT only: the assessment year, for example 2017-18. |
{
"searchId": "CPCSH0exampledemo0001",
"latestSummary": null,
"caseType": "APP - APPLICATION",
"filingNumber": "1821/2020",
"filingDate": "08-07-2020",
"filingYear": "2020",
"registrationNumber": "135/2020",
"registrationDate": "09-07-2020",
"cnrNumber": "HRFB010051662020",
"state": "Haryana",
"district": "Faridabad",
"courtName": "District and Sessions Courts, Faridabad",
"courtNumberAndJudge": "1-District and Sessions Judge",
"courtEstablishment": "District and Sessions Court, Faridabad",
"firstHearingDate": "09-July-2020",
"nextHearingDate": null,
"previousHearingDate": null,
"caseStage": null,
"decisionDate": "27-October-2020",
"natureOfDisposal": "Uncontested - DISMISSED AS WITHDRAWN",
"caseStatus": "Case Disposed",
"coram": null,
"judicial": null,
"causeListName": null,
"bench": null,
"shortOrder": null,
"petitioners": [
{
"petitionerName": "Acme Traders Pvt Ltd",
"petitionerCounsel": "Advocate - Advocate A"
}
],
"petitionersText": "1) Acme Traders Pvt Ltd\n Advocate - Advocate A",
"respondents": [
{
"respondentName": "Jane Doe Realty Ltd",
"respondentCounsel": null
}
],
"respondentsText": "1) Jane Doe Realty Ltd",
"acts": [
{
"act": "CODE OF CIVIL PROCEDURE",
"sections": "APP"
}
],
"interlocutoryApplicationDetails": null,
"caseHistory": [
{
"reg": "135/2020",
"causeListType": null,
"judge": "District and Sessions Judge",
"purpose": "Appearance",
"nextHearingDate": "06-08-2020",
"businessDate": "09-07-2020"
},
{
"reg": "135/2020",
"causeListType": null,
"judge": "District and Sessions Judge",
"purpose": "Appearance",
"nextHearingDate": "18-08-2020",
"businessDate": "06-08-2020"
},
{
"reg": "135/2020",
"causeListType": null,
"judge": "District and Sessions Judge",
"purpose": "Appearance",
"nextHearingDate": "16-09-2020",
"businessDate": "18-08-2020"
}
],
"orders": [
{
"number": "1",
"orderDate": "09-07-2020",
"judge": null,
"attachment": null,
"orderType": null,
"orderId": "8acd04f57027fe8c8a318e95d0ca74a7",
"downloadedAt": null
},
{
"number": "2",
"orderDate": "06-08-2020",
"judge": null,
"attachment": null,
"orderType": null,
"orderId": "af2538a37a645f61a09c177924d3ecb5",
"downloadedAt": null
},
{
"number": "3",
"orderDate": "18-08-2020",
"judge": null,
"attachment": null,
"orderType": null,
"orderId": "6e96db2dfa0d699908f8d5fed84af3ae",
"downloadedAt": null
}
],
"objections": null,
"category": null,
"subCategory": null,
"subSubCategory": null,
"fir": null,
"earlierCourts": null,
"documents": null,
"linkedCases": null,
"transfers": []
}{
"searchId": "CPCSH0exampledemo0002",
"latestSummary": null,
"caseType": "Appeal",
"filingNumber": "070111801964/2018",
"filingDate": "02-07-2018",
"filingYear": "2018",
"registrationNumber": "87/2018",
"registrationDate": "02-07-2018",
"cnrNumber": null,
"impugnType": null,
"impugnNumber": null,
"impugnDate": null,
"state": null,
"district": null,
"courtName": "National Green Tribunal, Principal Bench, New Delhi",
"courtNumberAndJudge": null,
"courtEstablishment": "PB",
"firstHearingDate": "05-07-2018",
"nextHearingDate": null,
"previousHearingDate": "15-12-2018",
"caseStage": null,
"decisionDate": "15-12-2018",
"natureOfDisposal": null,
"caseStatus": "DISPOSED",
"coram": "Member A, Member B, Member C, Member D, Member E",
"judicial": null,
"causeListName": null,
"bench": "Principal Bench, New Delhi",
"shortOrder": null,
"partyName": "Acme Traders Pvt Ltd VS STATE OF TAMILNADU",
"petitioners": [
{
"petitionerName": "Acme Traders Pvt Ltd",
"petitionerCounsel": "Advocate A",
"petitionerAddress": null
}
],
"petitionersText": "Acme Traders Pvt Ltd (Adv. Advocate A)",
"respondents": [
{
"respondentName": "Citizens Environment Forum",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "STATE OF TAMILNADU",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "TAMIL NADU POLLUTION CONTROL BOARD",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "TAMIL NADU ELECTRICITY BOARD",
"respondentCounsel": null,
"respondentAddress": null
}
],
"respondentsText": "Citizens Environment Forum, STATE OF TAMILNADU, TAMIL NADU POLLUTION CONTROL BOARD, TAMIL NADU ELECTRICITY BOARD",
"acts": [],
"interlocutoryApplicationDetails": [
{
"number": "MA/1051/2018",
"caseNumber": "MA/1051/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801965/2018"
},
{
"number": "MA/1073/2019",
"caseNumber": "MA/1073/2019",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801966/2018"
},
{
"number": "MA/1148/2018",
"caseNumber": "MA/1148/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801967/2018"
},
{
"number": "MA/1150/2018",
"caseNumber": "MA/1150/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801968/2018"
},
{
"number": "MA/1151/2018",
"caseNumber": "MA/1151/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801969/2018"
},
{
"number": "MA/1340/2018",
"caseNumber": "MA/1340/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801970/2018"
},
{
"number": "MA/1342/2018",
"caseNumber": "MA/1342/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801971/2018"
},
{
"number": "MA/1741/2018",
"caseNumber": "MA/1741/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801972/2018"
},
{
"number": "MA/1747/2018",
"caseNumber": "MA/1747/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801973/2018"
},
{
"number": "MA/982/2018",
"caseNumber": "MA/982/2018",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801974/2018"
},
{
"number": "MA/130/2025",
"caseNumber": "MA/130/2025",
"party": null,
"filingDate": null,
"nextDate": null,
"status": null,
"particulars": "Misc Application in disposed of cases",
"filingNumber": "070111801998/2025"
}
],
"caseHistory": [
{
"reg": 0,
"causeListType": null,
"judge": "Member A, Member B, Member C, Member D, Member E",
"purpose": null,
"nextHearingDate": null,
"businessDate": "15-12-2018",
"businessDescription": null,
"adjournmentReason": null
},
{
"reg": 1,
"causeListType": null,
"judge": "Member A, Member B, Member C, Member D, Member E",
"purpose": null,
"nextHearingDate": null,
"businessDate": "10-12-2018",
"businessDescription": null,
"adjournmentReason": null
},
{
"reg": 2,
"causeListType": null,
"judge": "Member A, Member B, Member C, Member D, Member E",
"purpose": null,
"nextHearingDate": null,
"businessDate": "07-12-2018",
"businessDescription": null,
"adjournmentReason": null
}
],
"orders": [],
"objections": null
}{
"searchId": "CPCSH0exampledemo0003",
"latestSummary": null,
"caseType": "Original Application",
"filingNumber": "070111601768/2026",
"filingDate": "16-09-2026",
"filingYear": "2026",
"registrationNumber": "550/2026",
"registrationDate": "23-09-2026",
"cnrNumber": null,
"impugnType": null,
"impugnNumber": null,
"impugnDate": null,
"state": null,
"district": null,
"courtName": "National Green Tribunal, Principal Bench, New Delhi",
"courtNumberAndJudge": null,
"courtEstablishment": "PB",
"firstHearingDate": "28-09-2026",
"nextHearingDate": "05-01-2027",
"previousHearingDate": "28-09-2026",
"caseStage": null,
"decisionDate": null,
"natureOfDisposal": null,
"caseStatus": "PENDING",
"coram": "Member A, Member B",
"judicial": null,
"causeListName": null,
"bench": "Principal Bench, New Delhi",
"shortOrder": null,
"partyName": "Jane Doe VS STATE OF HARYANA",
"petitioners": [
{
"petitionerName": "Jane Doe",
"petitionerCounsel": "Advocate A",
"petitionerAddress": null
}
],
"petitionersText": "Jane Doe (Adv. Advocate A)",
"respondents": [
{
"respondentName": "STATE OF HARYANA",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "HARYANA STATE POLLUTION CONTROL BOARD",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "ADDITIONAL CHIEF SECRETARY POWER DEPARTMENT",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "DEPUTY COMMISSIONER PANIPAT",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "CENTRAL POLLUTION CONTROL BOARD",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "COMMISSION FOR AIR QUALITY MANAGEMENT IN NATIONAL CAPITAL REGION AND ADJOINING AREAS (CAQM)",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "MINISTRY OF ENVIRONMENT FOREST & CLIMATE CHANGE",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "HARYANA POWER GENERATION CORPORATION LIMITED (HPGCL)",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "PANIPAT THERMAL POWER STATION",
"respondentCounsel": null,
"respondentAddress": null
}
],
"respondentsText": "STATE OF HARYANA, HARYANA STATE POLLUTION CONTROL BOARD, ADDITIONAL CHIEF SECRETARY POWER DEPARTMENT, DEPUTY COMMISSIONER PANIPAT, CENTRAL POLLUTION CONTROL BOARD, COMMISSION FOR AIR QUALITY MANAGEMENT IN NATIONAL CAPITAL REGION AND ADJOINING AREAS (CAQM), MINISTRY OF ENVIRONMENT FOREST & CLIMATE CHANGE, HARYANA POWER GENERATION CORPORATION LIMITED (HPGCL), PANIPAT THERMAL POWER STATION",
"acts": [
{
"act": "ENVIRONMENT (PROTECTION) ACT, 1986",
"sections": null
}
],
"interlocutoryApplicationDetails": [],
"caseHistory": [
{
"reg": 0,
"causeListType": null,
"judge": "Member A, Member B",
"purpose": null,
"nextHearingDate": null,
"businessDate": "28-09-2026",
"businessDescription": null,
"adjournmentReason": null
}
],
"orders": [
{
"number": "17906628246575995446abb58a8d4f48",
"orderDate": "28-09-2026",
"judge": "Member A, Member B",
"attachment": null,
"orderType": "Daily Order",
"orderId": "be84a18d2cb402c93957049357ec939c",
"downloadedAt": null
}
],
"objections": null
}{
"searchId": "CPCSH0exampledemo0004",
"latestSummary": null,
"caseType": "SEBI Appeal",
"filingNumber": "0149/2026",
"filingDate": "07-05-2026",
"filingYear": "2026",
"registrationNumber": "150/2026",
"registrationDate": null,
"cnrNumber": null,
"impugnType": null,
"impugnNumber": null,
"impugnDate": null,
"state": "Maharashtra",
"district": "Mumbai",
"courtName": "Securities Appellate Tribunal, Mumbai",
"courtNumberAndJudge": null,
"courtEstablishment": "MUM",
"firstHearingDate": "12-06-2026",
"nextHearingDate": "12-06-2026",
"previousHearingDate": "11-08-2026",
"caseStage": null,
"decisionDate": null,
"natureOfDisposal": null,
"caseStatus": "PENDING",
"coram": "Member A",
"judicial": null,
"causeListName": null,
"bench": "Mumbai",
"shortOrder": null,
"petitioners": [
{
"petitionerName": "Acme Traders Pvt Ltd",
"petitionerCounsel": "Advocate A",
"petitionerAddress": null
}
],
"petitionersText": "Acme Traders Pvt Ltd (Adv. Advocate A)",
"respondents": [
{
"respondentName": "BSE Limited",
"respondentCounsel": null,
"respondentAddress": null
}
],
"respondentsText": "BSE Limited",
"acts": [],
"interlocutoryApplicationDetails": [
{
"number": "MA 476/2026",
"caseNumber": "MA 476/2026",
"party": null,
"filingDate": "07-05-2026",
"nextDate": null,
"status": "Pending",
"particulars": "Urgency",
"disposalDate": null
},
{
"number": "MA 485/2026",
"caseNumber": "MA 485/2026",
"party": null,
"filingDate": "07-05-2026",
"nextDate": null,
"status": "Pending",
"particulars": "Exemption",
"disposalDate": null
}
],
"caseHistory": [
{
"reg": 0,
"causeListType": null,
"judge": "Member A",
"purpose": null,
"nextHearingDate": null,
"businessDate": "11-08-2026",
"businessDescription": null,
"adjournmentReason": null
},
{
"reg": 1,
"causeListType": null,
"judge": "Member A",
"purpose": null,
"nextHearingDate": null,
"businessDate": "12-06-2026",
"businessDescription": null,
"adjournmentReason": null
}
],
"orders": [
{
"number": "43870",
"orderDate": "11-08-2026",
"judge": "Member A",
"attachment": null,
"orderType": "Order",
"orderId": "56e6498bbaba68ed7980e207fcf81fd1",
"downloadedAt": null
},
{
"number": "42662",
"orderDate": "12-06-2026",
"judge": "Member A",
"attachment": null,
"orderType": "Order",
"orderId": "311cd141a3317c6f66b5bd6a0f6ec3b6",
"downloadedAt": null
}
],
"objections": null
}{
"searchId": "CPCSH0exampledemo0005",
"latestSummary": null,
"caseType": "SEBI Appeal",
"filingNumber": "0149/2026",
"filingDate": "07-05-2026",
"filingYear": "2026",
"registrationNumber": "150/2026",
"registrationDate": null,
"cnrNumber": null,
"impugnType": null,
"impugnNumber": null,
"impugnDate": null,
"state": "Maharashtra",
"district": "Mumbai",
"courtName": "Securities Appellate Tribunal, Mumbai",
"courtNumberAndJudge": null,
"courtEstablishment": "MUM",
"firstHearingDate": "12-06-2026",
"nextHearingDate": "12-06-2026",
"previousHearingDate": "11-08-2026",
"caseStage": null,
"decisionDate": null,
"natureOfDisposal": null,
"caseStatus": "PENDING",
"coram": "Member A",
"judicial": null,
"causeListName": null,
"bench": "Mumbai",
"shortOrder": null,
"petitioners": [
{
"petitionerName": "Acme Traders Pvt Ltd",
"petitionerCounsel": "Advocate A",
"petitionerAddress": null
}
],
"petitionersText": "Acme Traders Pvt Ltd (Adv. Advocate A)",
"respondents": [
{
"respondentName": "BSE Limited",
"respondentCounsel": null,
"respondentAddress": null
}
],
"respondentsText": "BSE Limited",
"acts": [],
"interlocutoryApplicationDetails": [
{
"number": "MA 476/2026",
"caseNumber": "MA 476/2026",
"party": null,
"filingDate": "07-05-2026",
"nextDate": null,
"status": "Pending",
"particulars": "Urgency",
"disposalDate": null
},
{
"number": "MA 485/2026",
"caseNumber": "MA 485/2026",
"party": null,
"filingDate": "07-05-2026",
"nextDate": null,
"status": "Pending",
"particulars": "Exemption",
"disposalDate": null
}
],
"caseHistory": [
{
"reg": 0,
"causeListType": null,
"judge": "Member A",
"purpose": null,
"nextHearingDate": null,
"businessDate": "11-08-2026",
"businessDescription": null,
"adjournmentReason": null
},
{
"reg": 1,
"causeListType": null,
"judge": "Member A",
"purpose": null,
"nextHearingDate": null,
"businessDate": "12-06-2026",
"businessDescription": null,
"adjournmentReason": null
}
],
"orders": [
{
"number": "43870",
"orderDate": "11-08-2026",
"judge": "Member A",
"attachment": null,
"orderType": "Order",
"orderId": "56e6498bbaba68ed7980e207fcf81fd1",
"downloadedAt": null
},
{
"number": "42662",
"orderDate": "12-06-2026",
"judge": "Member A",
"attachment": null,
"orderType": "Order",
"orderId": "311cd141a3317c6f66b5bd6a0f6ec3b6",
"downloadedAt": null
}
],
"objections": null
}{
"searchId": "CPCSH0exampledemo0006",
"latestSummary": null,
"caseType": "Income Tax Appeal",
"filingNumber": null,
"filingDate": "02-01-2023",
"filingYear": "2023",
"registrationNumber": "1/2023",
"registrationDate": null,
"cnrNumber": null,
"impugnType": null,
"impugnNumber": null,
"impugnDate": null,
"state": null,
"district": "Bangalore",
"courtName": "Income Tax Appellate Tribunal, Bangalore",
"courtNumberAndJudge": "Bench B",
"courtEstablishment": "BANGALORE",
"firstHearingDate": "14-02-2023",
"nextHearingDate": null,
"previousHearingDate": "08-03-2023",
"caseStage": "Disposed",
"decisionDate": "08-03-2023",
"natureOfDisposal": "Dismissed",
"caseStatus": "DISPOSED",
"coram": "Member A, Member B",
"judicial": null,
"causeListName": null,
"bench": "Bangalore",
"shortOrder": null,
"assessmentYear": "2017-18",
"petitioners": [
{
"petitionerName": "JANE DOE",
"petitionerCounsel": "Advocate A",
"petitionerAddress": "PUNE"
}
],
"petitionersText": "JANE DOE (Adv. Advocate A)",
"respondents": [
{
"respondentName": "DEPUTY COMMISSIONER OF INCOME-TAX, CPC",
"respondentCounsel": "Shri B, JCIT",
"respondentAddress": "BENGALURU"
}
],
"respondentsText": "DEPUTY COMMISSIONER OF INCOME-TAX, CPC (Adv. Shri B, JCIT)",
"acts": [],
"interlocutoryApplicationDetails": [],
"caseHistory": [
{
"reg": 0,
"causeListType": null,
"judge": "Member A, Member B",
"purpose": "HEARD",
"nextHearingDate": null,
"businessDate": "08-03-2023",
"businessDescription": "Heard in physical hearing.",
"adjournmentReason": null
},
{
"reg": 1,
"causeListType": null,
"judge": "Member A, Member B",
"purpose": null,
"nextHearingDate": "08-03-2023",
"businessDate": "07-03-2023",
"businessDescription": "Adjourned to 08/03/2023 (Wednesday) at the oral request of Assessee's Ld. Representative.",
"adjournmentReason": "oral request of Assessee's Ld. Representative"
},
{
"reg": 2,
"causeListType": null,
"judge": null,
"purpose": null,
"nextHearingDate": "07-03-2023",
"businessDate": "14-02-2023",
"businessDescription": "As Bench did not function on 14/02/2023 (Tuesday), hearing is adjourned to 07/03/2023 (Tuesday). No seperate Notice shall be issued.",
"adjournmentReason": null
}
],
"orders": [
{
"number": "1",
"orderDate": "08-03-2023",
"judge": "Member A, Member B",
"attachment": null,
"orderType": "Final Tribunal Order",
"result": "Dismissed",
"orderId": "14f9f45eab8b614b51fbc60dbb387254",
"downloadedAt": null
}
],
"objections": null
}{
"searchId": "CPCSH0exampledemo0007",
"latestSummary": null,
"caseType": "Income Tax (Transfer Pricing) Appeal",
"filingNumber": null,
"filingDate": "07-10-2025",
"filingYear": "2025",
"registrationNumber": "5/2025",
"registrationDate": null,
"cnrNumber": null,
"impugnType": null,
"impugnNumber": null,
"impugnDate": null,
"state": null,
"district": "Delhi",
"courtName": "Income Tax Appellate Tribunal, Delhi",
"courtNumberAndJudge": "Bench I",
"courtEstablishment": "DELHI",
"firstHearingDate": "02-02-2026",
"nextHearingDate": "30-07-2026",
"previousHearingDate": "30-07-2026",
"caseStage": "Heard",
"decisionDate": null,
"natureOfDisposal": null,
"caseStatus": "PENDING",
"coram": "Member A, Member B",
"judicial": null,
"causeListName": null,
"bench": "Delhi",
"shortOrder": null,
"assessmentYear": "2009-10",
"petitioners": [
{
"petitionerName": "ACME TRADERS PRIVATE LIMITED",
"petitionerCounsel": "Advocate A (virtual)",
"petitionerAddress": "NEW DELHI"
}
],
"petitionersText": "ACME TRADERS PRIVATE LIMITED (Adv. Advocate A (virtual))",
"respondents": [
{
"respondentName": "COMMISSIONER OF INCOME TAX (APPEALS)- 44",
"respondentCounsel": "Shri C, CIT(DR) & Shri D, Sr. DR",
"respondentAddress": "NEW DELHI"
}
],
"respondentsText": "COMMISSIONER OF INCOME TAX (APPEALS)- 44 (Adv. Shri C, CIT(DR) & Shri D, Sr. DR)",
"acts": [],
"interlocutoryApplicationDetails": [],
"caseHistory": [
{
"reg": 0,
"causeListType": null,
"judge": "Member A, Member B",
"purpose": "HEARD",
"nextHearingDate": null,
"businessDate": "30-07-2026",
"businessDescription": "The appeal is heard. Order is reserved.",
"adjournmentReason": null
},
{
"reg": 1,
"causeListType": null,
"judge": "Member C, Member A",
"purpose": null,
"nextHearingDate": "30-07-2026",
"businessDate": "02-06-2026",
"businessDescription": "Adjourned to 30/07/2026 (Thursday) at the written request of Department's Ld. Representative. Transfer to I Bench.",
"adjournmentReason": "written request of Department's Ld. Representative"
},
{
"reg": 2,
"causeListType": null,
"judge": "Member D, Member E",
"purpose": null,
"nextHearingDate": "02-06-2026",
"businessDate": "16-04-2026",
"businessDescription": "Hearing of the matter is adjourned to 02/06/2026 (Tuesday).",
"adjournmentReason": null
}
],
"orders": [],
"objections": null
}{
"searchId": "CPCSH0exampledemo0008",
"latestSummary": null,
"caseType": "Appeal",
"filingNumber": "505/2026",
"filingDate": "26-09-2026",
"filingYear": "2026",
"registrationNumber": "429/2026",
"registrationDate": null,
"cnrNumber": null,
"impugnType": null,
"impugnNumber": null,
"impugnDate": null,
"state": "Delhi",
"district": "New Delhi",
"courtName": "Appellate Tribunal for Electricity, New Delhi",
"courtNumberAndJudge": "Court-1",
"courtEstablishment": "DEL",
"firstHearingDate": null,
"nextHearingDate": "12-10-2026",
"previousHearingDate": null,
"caseStage": "For Admission",
"decisionDate": null,
"natureOfDisposal": null,
"caseStatus": "PENDING",
"coram": null,
"judicial": null,
"causeListName": null,
"bench": "Delhi",
"shortOrder": null,
"petitioners": [
{
"petitionerName": "Acme Energy Limited",
"petitionerCounsel": "Advocate A",
"petitionerAddress": null
}
],
"petitionersText": "Acme Energy Limited (Adv. Advocate A)",
"respondents": [
{
"respondentName": "State Electricity Regulatory Commission",
"respondentCounsel": null,
"respondentAddress": null
},
{
"respondentName": "State Power Management Company Limited",
"respondentCounsel": null,
"respondentAddress": null
}
],
"respondentsText": "State Electricity Regulatory Commission, State Power Management Company Limited",
"acts": [],
"interlocutoryApplicationDetails": [
{
"number": null,
"caseNumber": null,
"party": null,
"filingDate": null,
"nextDate": null,
"status": "PENDING",
"particulars": "For interim relief",
"disposalDate": null
},
{
"number": null,
"caseNumber": null,
"party": null,
"filingDate": null,
"nextDate": null,
"status": "PENDING",
"particulars": "For exemption from filling certified copy of impugned order",
"disposalDate": null
}
],
"caseHistory": [
{
"reg": 0,
"causeListType": "Electricity",
"judge": null,
"purpose": "For Admission",
"nextHearingDate": null,
"businessDate": null,
"businessDescription": "Pending",
"adjournmentReason": null
}
],
"orders": [
{
"number": "1",
"orderDate": "12-10-2026",
"judge": null,
"attachment": null,
"orderType": "Order",
"orderId": "9c2f41ab7de05b6184cf0a3d7e21bb40",
"downloadedAt": null
}
],
"objections": null
}{
"searchId": "CPCSH0exampledemo0009",
"latestSummary": null,
"caseType": "Appeal",
"filingNumber": "506/2026",
"filingDate": "30-09-2026",
"filingYear": "2026",
"registrationNumber": null,
"registrationDate": null,
"cnrNumber": null,
"impugnType": null,
"impugnNumber": null,
"impugnDate": null,
"state": "Delhi",
"district": "New Delhi",
"courtName": "Appellate Tribunal for Electricity, New Delhi",
"courtNumberAndJudge": "Court-1",
"courtEstablishment": "DEL",
"firstHearingDate": null,
"nextHearingDate": "21-10-2026",
"previousHearingDate": null,
"caseStage": "For Leave to File Appeal/Condonation of Delay/Waiver of Court Fee",
"decisionDate": null,
"natureOfDisposal": null,
"caseStatus": "PENDING",
"coram": null,
"judicial": null,
"causeListName": null,
"bench": "Delhi",
"shortOrder": null,
"petitioners": [
{
"petitionerName": "State Electricity Distribution Company Ltd.",
"petitionerCounsel": "Advocate B",
"petitionerAddress": null
}
],
"petitionersText": "State Electricity Distribution Company Ltd. (Adv. Advocate B)",
"respondents": [
{
"respondentName": "Acme Wind Power Private Limited",
"respondentCounsel": "Advocate C",
"respondentAddress": null
},
{
"respondentName": "State Electricity Regulatory Commission",
"respondentCounsel": null,
"respondentAddress": null
}
],
"respondentsText": "Acme Wind Power Private Limited (Adv. Advocate C), State Electricity Regulatory Commission",
"acts": [],
"interlocutoryApplicationDetails": [
{
"number": null,
"caseNumber": null,
"party": null,
"filingDate": null,
"nextDate": null,
"status": "PENDING",
"particulars": "For interim relief",
"disposalDate": null
},
{
"number": null,
"caseNumber": null,
"party": null,
"filingDate": null,
"nextDate": null,
"status": "PENDING",
"particulars": "For exemption from filling certified copy of impugned order",
"disposalDate": null
},
{
"number": null,
"caseNumber": null,
"party": null,
"filingDate": null,
"nextDate": null,
"status": "PENDING",
"particulars": "For condonation of delay in filing the Appeal",
"disposalDate": null
}
],
"caseHistory": [
{
"reg": 0,
"causeListType": "Electricity",
"judge": null,
"purpose": "For Leave to File Appeal/Condonation of Delay/Waiver of Court Fee",
"nextHearingDate": null,
"businessDate": null,
"businessDescription": "Pending",
"adjournmentReason": null
}
],
"orders": [],
"objections": null
}Download a case order
Returns a link to one order's document. Send the searchId from a previous case lookup and the orderId from that response's orders list. The url is a signed link that expires after 5 minutes and is generated fresh on every call, so do not store it. The document is the court's order with a CasePrimus provenance strip down the left margin of every page; it is not a certified copy. District Court orders, and orders you already downloaded, answer at once. For other courts the call waits for the download for up to 55 seconds. If it is still running you get 503 ORDER_DOWNLOAD_NOT_READY with a Retry-After header; send the same request again and it joins the download already in progress. Requires case.write.
Request URL
https://api.caseprimus.ai/api/caseprimus/v1/case-lookup/orders/downloadRequest headers
| Type | Name | Value / description | Optional |
|---|---|---|---|
| String | Content-Type | application/json | Required |
| String | X-CasePrimus-Api-Key | Your API key: {apiKey} | Required |
No API key yet? See Authentication.
Input parameters
| Field | Description |
|---|---|
searchIdstring Required | The searchId returned by the case lookup. |
orderIdstring Required | The orderId of the order, from the lookup's orders list. |
Sample request
BASE="https://api.caseprimus.ai/api/caseprimus/v1" curl -X POST "$BASE/case-lookup/orders/download" \ -H "X-CasePrimus-Api-Key: $CASEPRIMUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "searchId": "CPCSH0exampledemo0001", "orderId": "8acd04f57027fe8c8a318e95d0ca74a7" }'
const BASE = "https://api.caseprimus.ai/api/caseprimus/v1"; const res = await fetch(BASE + "/case-lookup/orders/download", { method: "POST", headers: { "Content-Type": "application/json", "X-CasePrimus-Api-Key": process.env.CASEPRIMUS_API_KEY, }, body: JSON.stringify({ "searchId": "CPCSH0exampledemo0001", "orderId": "8acd04f57027fe8c8a318e95d0ca74a7" }), }); const data = await res.json();
import os import requests BASE = "https://api.caseprimus.ai/api/caseprimus/v1" res = requests.request( "POST", BASE + "/case-lookup/orders/download", headers={"X-CasePrimus-Api-Key": os.environ["CASEPRIMUS_API_KEY"]}, json={ "searchId": "CPCSH0exampledemo0001", "orderId": "8acd04f57027fe8c8a318e95d0ca74a7", }, ) data = res.json()
Responses
| 200 | The order's document. |
| 400 | Malformed input (60001), this search record does not exist (SEARCH_RECORD_NOT_FOUND, 60436), or this court's orders cannot be downloaded right now (COURT_TYPE_NOT_SUPPORTED_FOR_ORDERS, 60437). |
| 403 | Caller lacks the case.write permission, or a free-trial account has used its order-download allowance (FREE_PLAN_USAGE_LIMIT_EXCEEDED, 61443). |
| 404 | The orderId is not one of this case's orders (ORDER_NOT_FOUND, 60434). |
| 422 | The court has no document for this order (ORDER_DOWNLOAD_FAILED, 60433; details.reason, null when no reason is known). |
| 503 | Still being downloaded after 55 seconds (ORDER_DOWNLOAD_NOT_READY, 61469). Send the same request again (Retry-After; details.retryAfterSeconds). |
Response fields (HTTP 200)
| Field | Description |
|---|---|
orderIdstring | |
urlstring | Signed link, valid for 5 minutes. Never store it. |
billedboolean | Whether this download was charged for. False for an order you had already downloaded, which is served from store for free. True means one unit was counted - which only happens when a document was actually delivered, so a call that answers 422 or 503 costs nothing. Added; a response from before it is absent rather than false. |
{
"orderId": "8acd04f57027fe8c8a318e95d0ca74a7",
"url": "https://files.example.com/hrfb010051662020-9f8e7d6c5b4a.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=300&X-Amz-Signature=...",
"billed": true
}Download all orders of a case as a zip
Starts a job that puts every order document of one case into a single zip. Send the searchId from a previous case lookup. The call returns at once with a jobId; poll the matching GET endpoint for the status and, once it is COMPLETE, a signed link to the zip. Most courts only release a document inside a court session, so a case with many orders takes minutes rather than seconds. Billing is per order at the same rate as a single order download, and only for the orders you have not already downloaded - the ones you have are put in the zip at no extra charge. The response says how many of each before you wait. Requires case.write.
Request URL
https://api.caseprimus.ai/api/caseprimus/v1/case-lookup/orders/download-allRequest headers
| Type | Name | Value / description | Optional |
|---|---|---|---|
| String | Content-Type | application/json | Required |
| String | X-CasePrimus-Api-Key | Your API key: {apiKey} | Required |
No API key yet? See Authentication.
Input parameters
| Field | Description |
|---|---|
searchIdstring Required | The searchId returned by the case lookup. Every order on that case goes into the zip. |
Sample request
BASE="https://api.caseprimus.ai/api/caseprimus/v1" curl -X POST "$BASE/case-lookup/orders/download-all" \ -H "X-CasePrimus-Api-Key: $CASEPRIMUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "searchId": "CPCSH0exampledemo0001" }'
const BASE = "https://api.caseprimus.ai/api/caseprimus/v1"; const res = await fetch(BASE + "/case-lookup/orders/download-all", { method: "POST", headers: { "Content-Type": "application/json", "X-CasePrimus-Api-Key": process.env.CASEPRIMUS_API_KEY, }, body: JSON.stringify({ "searchId": "CPCSH0exampledemo0001" }), }); const data = await res.json();
import os import requests BASE = "https://api.caseprimus.ai/api/caseprimus/v1" res = requests.request( "POST", BASE + "/case-lookup/orders/download-all", headers={"X-CasePrimus-Api-Key": os.environ["CASEPRIMUS_API_KEY"]}, json={ "searchId": "CPCSH0exampledemo0001", }, ) data = res.json()
Responses
| 200 | The bundle job was accepted. |
| 400 | Malformed input (60001), this search record does not exist (SEARCH_RECORD_NOT_FOUND, 60436), or the case has no order documents (EXPORT_NO_ORDERS, 61206). |
| 403 | Caller lacks the case.write permission, or a free-trial account has used its order-download allowance (FREE_PLAN_USAGE_LIMIT_EXCEEDED, 61443). |
| 500 | The bundle could not be queued (EXPORT_UNAVAILABLE, 61201). Nothing is charged; send the request again. |
Response fields (HTTP 200)
| Field | Description |
|---|---|
jobIdstring | Poll this with GET /case-lookup/orders/download-all/{jobId} to get the zip. |
statusenum | PENDING when the job is accepted. The zip is ready when the bundle reports COMPLETE. PENDING |
ordersobject | What the zip will contain, and what this request is charged for. |
totalinteger | How many orders go into the zip. |
billableinteger | How many are charged for - those not already downloaded. |
alreadyAvailableinteger | How many were already downloaded. Included in the zip, not charged again. |
{
"jobId": "CPEJ0bundledemo00001",
"status": "PENDING",
"orders": {
"total": 12,
"billable": 9,
"alreadyAvailable": 3
}
}{
"jobId": "CPEJ0bundledemo00002",
"status": "PENDING",
"orders": {
"total": 4,
"billable": 0,
"alreadyAvailable": 4
}
}Get the zip of a case's orders
Reports on a bundle started with the download-all endpoint. While the zip is being produced the status is PENDING or PROCESSING. Once it is COMPLETE the response carries url, a signed link to the zip that is valid for an hour and generated fresh on every call, so do not store it. A bundle that could not be produced comes back FAILED with failureReason. Polling is free. Requires case.read.
Request URL
https://api.caseprimus.ai/api/caseprimus/v1/case-lookup/orders/download-all/{jobId}Request headers
| Type | Name | Value / description | Optional |
|---|---|---|---|
| String | X-CasePrimus-Api-Key | Your API key: {apiKey} | Required |
No API key yet? See Authentication.
Path parameters
| Name | In | Required | Description |
|---|---|---|---|
jobId | path | Required | The jobId returned when the bundle was started. |
Sample request
BASE="https://api.caseprimus.ai/api/caseprimus/v1" curl "$BASE/case-lookup/orders/download-all/DOWNLOAD_ALL_ID" \ -H "X-CasePrimus-Api-Key: $CASEPRIMUS_API_KEY"
const BASE = "https://api.caseprimus.ai/api/caseprimus/v1"; const res = await fetch(BASE + "/case-lookup/orders/download-all/DOWNLOAD_ALL_ID", { method: "GET", headers: { "X-CasePrimus-Api-Key": process.env.CASEPRIMUS_API_KEY, }, }); const data = await res.json();
import os import requests BASE = "https://api.caseprimus.ai/api/caseprimus/v1" res = requests.request( "GET", BASE + "/case-lookup/orders/download-all/DOWNLOAD_ALL_ID", headers={"X-CasePrimus-Api-Key": os.environ["CASEPRIMUS_API_KEY"]}, ) data = res.json()
Responses
| 200 | The bundle's status, and the zip once it is complete. |
| 400 | Malformed jobId (60001), or no such bundle for this account (EXPORT_JOB_NOT_FOUND, 61200). |
| 403 | Caller lacks the case.read permission. |
Response fields (HTTP 200)
| Field | Description |
|---|---|
_idstring | |
kindenum | CASE_ORDERS_EXPORT |
resourceLabelstring | The case the orders belong to. |
createdinteger (int64) | |
statusenum | PENDING or PROCESSING while the zip is being made, then COMPLETE or FAILED. PENDINGPROCESSINGCOMPLETEFAILED |
urlstring or null | Signed link to the zip, valid for an hour. Only on COMPLETE. Never store it. |
expiresIninteger or null | Seconds the link stays valid. Only on COMPLETE. |
failureReasonstring or null | Why the bundle failed. Only on FAILED. |
ordersobject | |
totalinteger | |
billableinteger |
{
"_id": "CPEJ0bundledemo00001",
"kind": "CASE_ORDERS_EXPORT",
"resourceLabel": "HRFB010051662020",
"created": 1760774400000,
"status": "PROCESSING",
"failureReason": null,
"orders": {
"total": 12,
"billable": 9
}
}{
"_id": "CPEJ0bundledemo00001",
"kind": "CASE_ORDERS_EXPORT",
"resourceLabel": "HRFB010051662020",
"created": 1760774400000,
"status": "COMPLETE",
"url": "https://files.example.com/CPEJ0bundledemo00001/HRFB010051662020-orders.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=...",
"expiresIn": 3600,
"orders": {
"total": 12,
"billable": 9
}
}{
"_id": "CPEJ0bundledemo00002",
"kind": "CASE_ORDERS_EXPORT",
"resourceLabel": "HRFB010051662020",
"created": 1760774400000,
"status": "FAILED",
"failureReason": "The court session could not be established",
"orders": {
"total": 12,
"billable": 9
}
}Summarise a looked-up case with AI
Generates an AI summary of a case you have looked up, with a risk level and the reasoning behind it, without adding the case to a watchlist. Send the searchId from the case lookup. CasePrimus reads the document of every order and summarizes the case. The call returns immediately with an _id; poll the summary endpoint for the result. A case with no orders completes immediately. Every call starts a new summary, so call it again to regenerate. The most recent summary is also returned as latestSummary on the case lookup. Requires case.write.
Request URL
https://api.caseprimus.ai/api/caseprimus/v1/case-lookup/summarizeRequest headers
| Type | Name | Value / description | Optional |
|---|---|---|---|
| String | Content-Type | application/json | Required |
| String | X-CasePrimus-Api-Key | Your API key: {apiKey} | Required |
No API key yet? See Authentication.
Input parameters
| Field | Description |
|---|---|
searchIdstring Required | The searchId returned by the case lookup. |
Sample request
BASE="https://api.caseprimus.ai/api/caseprimus/v1" curl -X POST "$BASE/case-lookup/summarize" \ -H "X-CasePrimus-Api-Key: $CASEPRIMUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "searchId": "CPCSH0exampledemo0001" }'
const BASE = "https://api.caseprimus.ai/api/caseprimus/v1"; const res = await fetch(BASE + "/case-lookup/summarize", { method: "POST", headers: { "Content-Type": "application/json", "X-CasePrimus-Api-Key": process.env.CASEPRIMUS_API_KEY, }, body: JSON.stringify({ "searchId": "CPCSH0exampledemo0001" }), }); const data = await res.json();
import os import requests BASE = "https://api.caseprimus.ai/api/caseprimus/v1" res = requests.request( "POST", BASE + "/case-lookup/summarize", headers={"X-CasePrimus-Api-Key": os.environ["CASEPRIMUS_API_KEY"]}, json={ "searchId": "CPCSH0exampledemo0001", }, ) data = res.json()
Responses
| 200 | Summarization job queued (PENDING), or completed immediately (COMPLETE) for a case with no orders to read. |
| 400 | Malformed input (60001), or the searchId is not one of this account's lookups (SEARCH_RECORD_NOT_FOUND, 60436). |
| 403 | Caller lacks the case.write permission, or a free-trial account has used its summarization allowance (FREE_PLAN_USAGE_LIMIT_EXCEEDED, 61443). |
| 500 | The summary request could not be started (CASE_LOOKUP_FAILED, 60406). Try again shortly. |
Response fields (HTTP 200)
| Field | Description |
|---|---|
_idstring | The id of the summary request. Use it to poll for the result. |
statusenum | PENDING while the summary is being produced; COMPLETE straight away for a case with no orders. A FAILED status only ever appears when you poll. PENDINGCOMPLETE |
{
"_id": "CPCSS0exampledemo0001",
"status": "PENDING"
}{
"_id": "CPCSS0exampledemo0002",
"status": "COMPLETE"
}Get an AI case summary
Returns the current status of a summary you requested. orderSummaries, riskLevel and caseSummary are included on every poll, not only once the status is COMPLETE, so you can show each order's summary as soon as it finishes. Poll until the status is COMPLETE or FAILED (error says why). An order's attachment is only "AVAILABLE" or null: the document itself comes from the order download endpoint. caseLabels says what the case is about, with the evidence it was read from in caseLabelBasis and caseLabelEvidence. Requires case.read.
Request URL
https://api.caseprimus.ai/api/caseprimus/v1/case-lookup/summarize/{id}Request headers
| Type | Name | Value / description | Optional |
|---|---|---|---|
| String | X-CasePrimus-Api-Key | Your API key: {apiKey} | Required |
No API key yet? See Authentication.
Path parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | Required | The _id returned when you requested the summary. |
Sample request
BASE="https://api.caseprimus.ai/api/caseprimus/v1" curl "$BASE/case-lookup/summarize/SUMMARIZE_ID" \ -H "X-CasePrimus-Api-Key: $CASEPRIMUS_API_KEY"
const BASE = "https://api.caseprimus.ai/api/caseprimus/v1"; const res = await fetch(BASE + "/case-lookup/summarize/SUMMARIZE_ID", { method: "GET", headers: { "X-CasePrimus-Api-Key": process.env.CASEPRIMUS_API_KEY, }, }); const data = await res.json();
import os import requests BASE = "https://api.caseprimus.ai/api/caseprimus/v1" res = requests.request( "GET", BASE + "/case-lookup/summarize/SUMMARIZE_ID", headers={"X-CasePrimus-Api-Key": os.environ["CASEPRIMUS_API_KEY"]}, ) data = res.json()
Responses
| 200 | Current summarization status. |
| 400 | This summary request does not exist (CASE_SUMMARY_NOT_FOUND, 60435), or the id is malformed (60001). |
| 403 | Caller lacks the case.read permission. |
Response fields (HTTP 200)
| Field | Description |
|---|---|
_idstring | The id of the summary request. |
statusenum | PENDINGCOMPLETEFAILED |
riskLevelenum or null | The risk level once the summary is complete: VERY_HIGH, HIGH, MODERATE, LOW or UNCLASSIFIED. Null until then. VERY_HIGHHIGHMODERATELOWUNCLASSIFIED |
caseSummarystring or null | The summary of the case. Null until it is complete. |
riskJustificationstring or null | Why this risk level was given. Null until the summary is complete. |
caseLabelsarray of string or null | What this case is ABOUT, from the same analysis call that wrote `caseSummary`. The same catalogue the watchlist and the litigation report use, so the three never disagree about what a case is. One or more ids, or `PROCEDURAL_ONLY` (neither the orders nor the court record reveal the subject matter) or `OTHERS` (the subject matter is clear but we have no id for it). Null until the analysis completes. |
caseLabelBasisenum or null | Which evidence the labels came from. `ORDER` - the case's own orders say so. `RECORD` - the case has no readable order and the label comes from the court's index entry, which is weaker and never reads HIGH. `BOTH` - they agree. `NEITHER` - `PROCEDURAL_ONLY`. ORDERRECORDBOTHNEITHER |
caseLabelConfidenceenum or null | How good the evidence is, not how strongly we feel. A label alleging conduct requires an order to describe that conduct, never a statute name. HIGHMEDIUMLOW |
caseLabelEvidencestring or null | The words that decided the labels, quoted. Published so a label can be checked rather than taken on trust. |
casePartySideenum or null | Which side the company is on. The same outcome words mean opposite things depending on it. PETITIONERRESPONDENTBOTHUNCLEAR |
caseSuggestedLabelobject or null | Set only where `caseLabels` is `OTHERS`: our own proposal for what this kind of case should be called, because a case we cannot categorise is still a case you need described. |
idstring | |
labelstring | |
whystring | |
orderSummariesarray of object | A summary for each order, each with its own status. |
orderKeystring | The orderId of the order, as in the lookup's orders list. |
orderNumberstring or null | |
orderDatestring or null | |
judgestring or null | |
orderTypestring or null | |
attachmentenum or null | AVAILABLE when a document was found for the order, null when not. It is never a link: get the document with POST /case-lookup/orders/download. AVAILABLE |
statusenum | PENDING while being read; COMPLETE with a summary; SKIPPED when the order's document could not be read (error says why); FAILED when the document was read but the summary could not be produced. PENDINGCOMPLETESKIPPEDFAILED |
summarystring or null | Null until the order is COMPLETE. |
detectedLanguagestring or null | The language of the order, when it is not English or was detected. |
errorstring or null | Why the order was SKIPPED or FAILED. Otherwise null. |
errorClassstring or null | For a FAILED order, the kind of failure (for example TOKEN_LIMIT, TIMEOUT, RATE_LIMIT, SERVER_ERROR). Otherwise null. |
computedAtinteger or null | Epoch ms when the order's status was settled. Null while PENDING. |
errorstring or null | Why the summary failed, if it did. Otherwise null. |
{
"_id": "CPCSS0exampledemo0001",
"status": "PENDING",
"riskLevel": null,
"caseSummary": null,
"riskJustification": null,
"caseLabels": null,
"caseLabelBasis": null,
"caseLabelConfidence": null,
"caseLabelEvidence": null,
"casePartySide": null,
"caseSuggestedLabel": null,
"orderSummaries": [
{
"orderKey": "8acd04f57027fe8c8a318e95d0ca74a7",
"orderNumber": "1",
"orderDate": "09-07-2020",
"judge": null,
"orderType": null,
"attachment": "AVAILABLE",
"status": "COMPLETE",
"summary": "Adjourned the application to 06-08-2020 for appearance of the parties.",
"detectedLanguage": "English",
"error": null,
"errorClass": null,
"computedAt": 1757000071000
},
{
"orderKey": "af2538a37a645f61a09c177924d3ecb5",
"orderNumber": "2",
"orderDate": "06-08-2020",
"judge": null,
"orderType": null,
"attachment": "AVAILABLE",
"status": "PENDING",
"summary": null,
"detectedLanguage": null,
"error": null,
"errorClass": null,
"computedAt": null
},
{
"orderKey": "6e96db2dfa0d699908f8d5fed84af3ae",
"orderNumber": "3",
"orderDate": "18-08-2020",
"judge": null,
"orderType": null,
"attachment": "AVAILABLE",
"status": "PENDING",
"summary": null,
"detectedLanguage": null,
"error": null,
"errorClass": null,
"computedAt": null
}
],
"error": null
}{
"_id": "CPCSS0exampledemo0001",
"status": "COMPLETE",
"riskLevel": "LOW",
"caseSummary": "An application under the Code of Civil Procedure filed by Acme Traders Pvt Ltd against Jane Doe Realty Ltd before the District and Sessions Judge, Faridabad. The matter was adjourned three times for appearance between July and September 2020 and was dismissed as withdrawn, uncontested, on 27 October 2020.",
"caseLabels": [
"civil.general"
],
"caseLabelBasis": "RECORD",
"caseLabelConfidence": "MEDIUM",
"caseLabelEvidence": "Code of Civil Procedure | Section 151; dismissed as withdrawn, uncontested",
"casePartySide": "PETITIONER",
"caseSuggestedLabel": null,
"riskJustification": "The case is disposed of, and the only outcome is a withdrawal by the applicant: there was no contested hearing, no adverse finding and no order against the company.",
"orderSummaries": [
{
"orderKey": "8acd04f57027fe8c8a318e95d0ca74a7",
"orderNumber": "1",
"orderDate": "09-07-2020",
"judge": null,
"orderType": null,
"attachment": "AVAILABLE",
"status": "COMPLETE",
"summary": "Adjourned the application to 06-08-2020 for appearance of the parties.",
"detectedLanguage": "English",
"error": null,
"errorClass": null,
"computedAt": 1757000071000
},
{
"orderKey": "af2538a37a645f61a09c177924d3ecb5",
"orderNumber": "2",
"orderDate": "06-08-2020",
"judge": null,
"orderType": null,
"attachment": "AVAILABLE",
"status": "COMPLETE",
"summary": "Adjourned the application to 18-08-2020 for appearance of the parties.",
"detectedLanguage": "English",
"error": null,
"errorClass": null,
"computedAt": 1757000073000
},
{
"orderKey": "6e96db2dfa0d699908f8d5fed84af3ae",
"orderNumber": "3",
"orderDate": "18-08-2020",
"judge": null,
"orderType": null,
"attachment": "AVAILABLE",
"status": "COMPLETE",
"summary": "Adjourned the application to 16-09-2020 for appearance of the parties.",
"detectedLanguage": "English",
"error": null,
"errorClass": null,
"computedAt": 1757000072000
}
],
"error": null
}Court types
Set courtType to one of these codes. Send the cnr for District Courts, the Supreme Court and High Courts where you have it.
| Code | Court or tribunal |
|---|---|
| SC | Supreme Court of India |
| HC | High Courts |
| DC | District Courts |
| CC | Consumer Commissions |
| NCLT | National Company Law Tribunal |
| NCLAT | National Company Law Appellate Tribunal |
| DRT | Debts Recovery Tribunals |
| DRAT | Debts Recovery Appellate Tribunals |
| GSTAT | Goods and Services Tax Appellate Tribunal |
| CESTAT | Customs, Excise and Service Tax Appellate Tribunal |
| NGT | National Green Tribunal |
| SAT | Securities Appellate Tribunal |
| ITAT | Income Tax Appellate Tribunal |
| APTEL | Appellate Tribunal for Electricity |
How order downloads behave
Short-lived links
The url is a signed link that expires after 5 minutes and is generated fresh on every call, so do not store it.
Provenance on every page
The document is the court's order with a CasePrimus strip down the left margin of every page. It is not a certified copy.
District Court orders are immediate
District Court orders, and orders you have already downloaded, answer at once.
Other courts can take longer
For other courts the call waits for the download for up to 55 seconds. If it is still running you get 503 with Retry-After; send the same request again and it joins the download already in progress.
Summary statuses
| Status | Meaning |
|---|---|
| PENDING | The summary is still being produced. Order summaries that are finished are already included. |
| COMPLETE | The summary, risk level and risk justification are ready. |
| FAILED | The summary could not be produced. The error field says why. |
Risk levels
The riskLevel field of a summary uses these values.
| Value | Meaning |
|---|---|
| VERY_HIGH | Very high risk |
| HIGH | High risk |
| MODERATE | Moderate risk |
| LOW | Low risk |
| UNCLASSIFIED | No risk level has been assigned |
Decision support, not legal advice
Errors
Errors use the HTTP status and a JSON body with a stable numeric code. These are the errors documented for the Live Case Lookup API. The full format, and the limits that apply to every call, are on Rate limits & errors.
| Status | Code | Message |
|---|---|---|
| 400 | 4006 | Invalid/bad value provided for the CNR |
| 400 | 60435 | This case summary request does not exist |
| 400 | 60436 | This search record does not exist |
| 400 | 61200 | Export job does not exist |
| 400 | 61206 | This case has no order documents to download |
| 404 | 60434 | No matching order was found for the number and date provided |
| 404 | 60438 | No case was found at the court for this reference. Check the court, bench, case type, number and year, and try again |
| 422 | 60433 | Could not download this order right now, please try again shortly |
| 500 | 60406 | Could not look up this case right now, please try again shortly |
| 503 | 61469 | This order is still being downloaded from the court. Send the same request again in a few seconds - nothing is charged until it is delivered |
Frequently asked questions
What is a CNR?
A CNR is a 16-character code that identifies a case in India's eCourts system. If you have it, it is the quickest way to look a case up for District Courts, the Supreme Court and High Courts.
Does a lookup start monitoring the case?
No. A lookup is one-time and on demand. It starts no monitoring and needs no party. To follow a case, add it with the Case Monitoring API, or watch a company or person with the Parties Watchlist API.
Can I download the court's order?
Yes. Send the searchId from the lookup and the orderId of the order to the order download endpoint. You get a signed link that expires after 5 minutes. The document carries a CasePrimus provenance strip and is not a certified copy. To get every order, download them as one zip.
How long does an order download take?
District Court orders, and orders you already downloaded, answer at once. For other courts the call waits up to 55 seconds. If the download is still running you get a 503 with a Retry-After header; send the same request again.
Which courts and tribunals are covered?
District Courts, High Courts, the Supreme Court, Consumer Commissions, and the NCLT, NCLAT, GSTAT, DRT, DRAT, CESTAT, NGT, SAT, ITAT and APTEL tribunals.
What happens if the case does not exist?
If the court has no such case you get a 404 with the code CASE_NOT_FOUND_AT_COURT, and nothing is charged. If the reference matches more than one case you get a 400 with the code 4003; send a more specific identifier.
What does the AI summary return?
A plain-language case summary, a risk level, a written risk justification, and a summary for each order on the case. The request returns immediately with an _id, and the summary is ready when the status is COMPLETE.
Can I generate a summary again?
Yes. Every request starts a new summary. The most recent one is returned as latestSummary on the case lookup.
Is the risk level legal advice?
No. The summary and risk level are produced by AI as decision support. Have a qualified person confirm anything you rely on.