Download court orders and judgments by API, for any CNR
Every order a court uploads is a PDF sitting on a government server behind a CAPTCHA. The Order PDF endpoint fetches it for you by CNR and filename, so your software can store it, show it or hand it to a reader without anyone opening a court portal.
Read the case first to get the list of orders and their filenames, then call the Order PDF endpoint for the ones you need. If you want the words rather than the document, the Markdown or AI endpoints are a better fit.
Docs, prices and the example order index read on 15 November 2026.
Last updated: 15 November 2026
Key takeaways
- Two calls: the case detail call lists each order’s date, type and filename; the Order PDF call fetches one order.
- Two versions: by default you get a watermarked, digitally signed copy;
signed=falsegives the raw court PDF. The price is the same. - Price: ₹1.25 per order at the Enterprise base rate, ₹3.75 on Pay As You Go.
- Choose the right format: PDF for filing and display, Markdown for search and AI, AI summary for triage.
- Not a court-certified copy: for anything you will file in court, apply to the court’s copying section.
How do I find the orders on a case?
Read the case by CNR. The response lists interim orders and judgments, each with a date, a type and a filename.
Every Indian court case has a 16-character CNR. Our CNR guide explains how to read one. Call GET /api/partner/case/{cnr} and look at two arrays: interimOrders and judgmentOrders. Each entry carries an orderUrl, which is the filename you pass to the download call. On large cases with hundreds of orders, page through the full index rather than relying on the most recent entries.
Here is the order index of a real Supreme Court civil appeal, CNR SCIN010525092026, read on 15 November 2026:
| Date | Type | Filename |
|---|---|---|
| 24 September 2026 | Judgement of main case | order-6.pdf |
| 24 September 2026 | Record of proceedings | order-5.pdf |
| 23 September 2026 | Record of proceedings | order-4.pdf |
| 18 September 2026 | Record of proceedings | order-3.pdf |
| 15 September 2026 | Record of proceedings | order-2.pdf |
| 7 September 2026 | Record of proceedings | order-1.pdf |
Two things to notice. The filename does not follow date order (the judgment is order-6, the record of proceedings for the same day is order-5), so always pick by type and date, never by assuming the highest number is the judgment. And a record of proceedings is a short note of what happened at a hearing, while the judgment is the reasoned decision. Most users want one or the other, not both.
How do I download an order PDF?
Call the Order PDF endpoint with the CNR and the filename.
GET /api/partner/case/SCIN010525092026/order/order-6.pdf Authorization: Bearer YOUR_API_KEY # optional: the raw court PDF, without watermark or signature GET /api/partner/case/SCIN010525092026/order/order-6.pdf?signed=false
The response is JSON describing the file: the cnr, the filename, a suggested downloadFilename for saving it, and a message. The docs point you to the document download for the bytes themselves; if you want the PDF delivered inside the JSON, the Order Markdown endpoint returns it as base64 alongside the text, as described in our Order Markdown API guide.
Signed or raw: which copy should I take?
Take the signed copy for anything you show or share, and the raw copy when you need the court’s file byte for byte.
The signed parameter defaults to true. The docs describe that version as watermarked and digitally signed, which lets a reader see where the copy came from and check it has not been altered since. Setting signed=false returns the PDF exactly as the court published it, with no watermark or signature. Both cost the same.
Neither is a certified copy issued by the court. If you need to file an order, produce it as evidence or rely on it in a formal process, apply for a certified copy through the court’s copying section or its e-copy service.
PDF, Markdown or AI summary: which should I buy?
Buy the format your next step needs. Paying for a PDF and then running your own OCR usually costs more than the Markdown call.

- PDF when the document itself matters: a client portal that shows the order, an archive, a file that goes into a loan or compliance record.
- Markdown when you will search, quote or feed the text to a model. Indian orders are often scanned, and the Markdown call has already done the OCR.
- AI summary when a person needs to know what happened without reading ten pages. See the Court Order Summary API for what it returns and where it can mislead.
What does a document archive cost?
| Monthly volume | Order PDF (Enterprise) | Order PDF (PAYG) | Plus case reads to find filenames (Enterprise) |
|---|---|---|---|
| 1,000 orders | ₹1,250 | ₹3,750 | ₹500 if each order is on a different case |
| 10,000 orders | ₹12,500 | ₹37,500 | ₹5,000 if each order is on a different case |
Store what you download. An order does not change once uploaded, so fetching it twice is wasted money. Key your store on CNR plus filename.
How many orders does a typical case have?
Usually one, sometimes dozens. Budgeting an archive by “cases” can mislead, because order counts vary enormously. We grouped the 16,58,40,375 case records in our index that carry at least one order by how many orders they hold.
| Orders on the case | Case records | Share of records with orders | Cost to download all at ₹1.25 |
|---|---|---|---|
| 1 | About 12.2 crore | 74% | ₹1.25 |
| 2 to 4 | 2,50,07,747 | 15% | ₹2.50 to ₹5 |
| 5 to 19 | 1,44,48,646 | 9% | ₹6.25 to ₹23.75 |
| 20 to 49 | 33,39,014 | 2% | ₹25 to ₹61.25 |
| 50 or more | 6,04,993 | 0.4% | ₹62.50 and up |
Three in four cases with orders have exactly one, which may be the final order or judgment or a single interim order. The long tail is where costs hide: a matter with 60 orders of adjournments and interim directions costs ₹75 to download in full, and many of those pages say little. If your purpose is the outcome, download only the judgment or final order, picked by type and date from the order index.
Which orders to download, by purpose
| Purpose | Download | Skip |
|---|---|---|
| Client portal for a law firm | Every order, as it arrives | Nothing; clients expect the full file |
| Background check or due diligence | Final order or judgment; charge-related orders in criminal cases | Routine adjournment orders |
| Lender or insurer docket | Interim orders that change position (stay, deposit, attachment) and the final order | Pure adjournments |
| Research or AI training set | Judgments, as Markdown rather than PDF | PDFs, unless you need the layout |
Orders also arrive in a pattern. Courts that upload regularly post a short order or record of proceedings after a hearing and the judgment at the end, though upload rates differ a lot from state to state. If you poll a case only when the CNR batch shows it was listed, you pick up new orders soon after the hearings that produce them, with few wasted reads; our guide to cause list automation shows that loop. For filing in court rather than reading, use the route in our certified copy guide.
What if an order is missing?
- The hearing happened but no order is listed: courts upload orders days or weeks later. Refresh the case with the Case Refresh API and check again.
- The case shows no orders at all: many district court matters at early stages have none uploaded. That is not an error.
- The filename does not match: use the exact
orderUrlvalue from the case response; do not build filenames yourself.
Can I do this without writing code?
Yes, for one-off needs. On ecourtsindia.com you can open a case and download its orders from the case page; our guide to downloading court orders online walks through it. Through the MCP server, an assistant such as Claude can list a case’s orders with list_case_orders and read any of them with get_order_markdown or get_order_ai_analysis.
Sources and method
- eCourtsIndia API docs and pricing, ecourtsindia.com/api/docs and /api/pricing, read 15 November 2026.
- Order index of Supreme Court case SCIN010525092026, read through the eCourts MCP on 15 November 2026.
Frequently asked questions
How do I download a court order PDF by API?
Read the case by CNR to get each order’s filename, then call GET /api/partner/case/{cnr}/order/{filename}. Use the exact orderUrl value from the case response as the filename.
What does the signed parameter do?
By default the endpoint returns a watermarked, digitally signed copy. Setting signed=false returns the raw PDF as the court published it. The price is the same.
How much does an order download cost?
₹1.25 per order at the Enterprise base rate and ₹3.75 on Pay As You Go, before GST. The case read that lists the filenames costs ₹0.50 or ₹1.50.
Is the downloaded order a certified copy?
No. It is a copy of the order the court published. For filing or evidence, apply to the court’s copying section for a certified copy.
Should I download the PDF or the Markdown?
Take the PDF when the document itself matters. Take the Markdown when you will search, quote or feed the text to a model, because the OCR is already done.
How many orders does a court case usually have?
In our index, about 74% of case records with orders have exactly one, 15% have two to four, and about 6 lakh records have 50 or more.
Should I download every order on a case?
Only if your purpose needs the full file, such as a client portal. For checks and research, download the final order or judgment and any interim order that changes a party’s position.
How many case records have orders online?
16,58,40,375 of the 35,41,02,686 case records in our index on 15 November 2026, about 47%, carry at least one order.
Important: This guide is published by Billion Insights Ventures Pvt. Ltd., the company behind eCourtsIndia. It is not legal advice. Court data shown here is a copy of public court records as read on the date stated at the top of this page and is not a certified copy. A name match is not identity, a pending case is not guilt, and a disposed case is a status, not an outcome. Prices, limits, counts and examples were checked on that date and can change. eCourtsIndia is a private legal-technology platform and is not affiliated with any court, the e-Committee of the Supreme Court or the Government of India. Found an error? Write to support@ecourtsindia.com.



