The eCourts Cheat Sheet: 15 Prompts You Can Copy-Paste Into ChatGPT, Claude, or Gemini to Look Up Indian Court Data

You read the launch post. You understand the problem. Now here is the part you actually came for — the prompts.

This post gives you 15 ready-to-use prompts that you can copy and paste into ChatGPT, Claude, Gemini, or any AI assistant that can run Python code. Each prompt tells the AI to use the bharat-courts SDK to pull real data from eCourts. No programming. No portal. No CAPTCHAs.

One-Time Setup (2 Minutes)

Before you use the prompts, you need to install bharat-courts once. You only do this once per machine.

Option A: Ask your AI to do it.

Paste this into Claude Code, ChatGPT (Code Interpreter), or any AI tool that can run terminal commands:

Install the bharat-courts Python package by running: pip install bharat-courts

That is it. The AI installs it for you.

Option B: Do it yourself.

Open Terminal (Mac) or Command Prompt (Windows).

Step 1 — Install the SDK (everyone needs this):

pip install bharat-courts

Step 2 — Register AI skills (if you use Claude Code, GitHub Copilot, or Cursor):

bharat-courts install-skills

Step 1 installs the SDK itself. Step 2 registers bharat-courts as a skill with your AI assistant so it automatically knows how to use it when you ask court-related questions.

If you skip Step 2, everything still works — you just need to say "using the bharat-courts SDK" in your prompts. With it, your AI assistant recognizes court-related questions and uses bharat-courts on its own.

The Prompts

Every prompt below is designed to be copied as-is and pasted into your AI assistant. Replace the parts in [brackets] with your actual details.

Case Status

1. Check if a specific case is pending or disposed

Using the bharat-courts Python SDK, look up the case status for case type [W.P.(C)], case number [4520], year [2023] in [Bombay] High Court. First use list_case_types() to find the correct numeric code for the case type, then search. Tell me the current status, next hearing date, judges, and full party names.

2. Find all cases for a party in a High Court

Using the bharat-courts Python SDK, search for all pending cases where [Tata Motors] is a party in [Delhi] High Court for the year [2025]. List each case with its case number, opposing party, status, and next hearing date.

3. Find all cases — pending and disposed — for a party

Using the bharat-courts Python SDK, search for ALL cases (both pending and disposed) where [HDFC Bank] is a party in [Karnataka] High Court for the year [2024]. Show results in a table with columns: Case Number, Petitioner, Respondent, Status, Next Hearing Date.

Court Orders and Judgments

4. Download all orders in a case

Using the bharat-courts Python SDK, find all court orders for case type [W.P.(C)], case number [3421], year [2024] in [Delhi] High Court. First use list_case_types() to find the numeric code. Then list every order with its date, type, and judge. Download each order as a PDF and save them to a folder called "case_orders".

5. Get only the latest order in a case

Using the bharat-courts Python SDK, look up the most recent order in case type [CS(OS)], case number [445], year [2025] in [Bombay] High Court. Tell me the date, which judge passed it, and what type of order it is. Download the PDF.

Cause Lists

6. Check tomorrow's cause list

Using the bharat-courts Python SDK, get the civil cause list for [Delhi] High Court for [22-03-2026] (use DD-MM-YYYY format). List every bench and cause list type available.

7. Check cause list for a District Court

Using the bharat-courts Python SDK, get the cause list for the district court in [Patna], [Bihar] for today. Use the DistrictCourtClient. First discover the state code, district code, and court complex for the location. Then pull the cause list and show me each case with its serial number, case number, parties, and judge.

District Courts

8. Search by party name in a District Court

Using the bharat-courts Python SDK and the DistrictCourtClient, find all cases where [Kumar] is a party in any court in [Patna] district, [Bihar] state, for the year [2024]. First use list_states(), list_districts(), and list_complexes() to discover the correct court codes. Then run the search and show me each case with its number, parties, and status.

9. Search across multiple district courts in a state

Using the bharat-courts Python SDK, search for cases involving [State Bank of India] across all district courts in [Maharashtra] for [2024]. Use list_districts() to get all districts, then list_complexes() for each, then search each court complex. Show results grouped by district.

Supreme Court

10. Search Supreme Court judgments by party name

Using the bharat-courts Python SDK and the SCIClient, search for all Supreme Court judgments involving [Union of India]. For each judgment, show the title, date, case number, and bench composition (judges). No CAPTCHA is needed for the Supreme Court.

11. Get all Supreme Court judgments from a specific month

Using the bharat-courts Python SDK and the SCIClient, find all Supreme Court judgments from [June 2024]. List them with title, date, and judges. Then download the PDFs for the first 5 results.

Judgment Research

12. Search for judgments on a legal topic

Using the bharat-courts Python SDK and the JudgmentSearchClient, search for High Court judgments containing the phrase [right to privacy]. Show the total count, and for the first 10 results, show the title, court, date, and CNR number. Then download those 10 as PDFs.

13. Research how courts handle a specific issue

Using the bharat-courts Python SDK, search the judgment portal for [arbitration clause enforceability]. Get results from multiple pages (use search_all). For each judgment, show the title, court name, and date. Group the results by High Court so I can see which courts have the most judgments on this topic.

Bulk and Multi-Court Workflows

14. Litigation history scan across multiple High Courts

Using the bharat-courts Python SDK, search for all cases (pending and disposed) involving [Infosys] across Delhi, Bombay, Karnataka, Madras, and Calcutta High Courts for the years 2023, 2024, and 2025. For each court and year, search using case_status_by_party(). Compile all results into a single table with columns: Court, Year, Case Number, Petitioner, Respondent, Status. At the end, give me a summary: total cases found, how many are pending vs disposed, and which court has the most cases.

15. Export case data to a spreadsheet

Using the bharat-courts Python SDK, find all pending cases for [Reliance Industries] in [Delhi] High Court for [2024] and [2025]. Export the results as a CSV file with columns: Case Number, CNR Number, Petitioner, Respondent, Status, Next Hearing Date, Judges. Save it as "reliance_delhi_cases.csv".

Tips for Better Results

Be specific about the court. Say "Delhi High Court" or "Bombay High Court, Nagpur Bench" — not just "the court." The SDK supports 25 High Courts and all their benches.

Always mention the year. eCourts requires a year for party name searches. If you do not specify one, the AI will have to guess or ask you.

Use the right case type name. If you know your case is a "Writ Petition (Civil)", say that. The AI will use list_case_types() to find the right numeric code. If you only know the case number format (like "WP(C) 4520/2023"), that is fine too — the AI will figure it out.

For district courts, name the city and state. The SDK needs to navigate a hierarchy of state → district → court complex → establishment. Giving the city and state gives the AI enough context to discover the right codes.

If a CAPTCHA fails, just re-run the prompt. The SDK has automatic retry logic, but eCourts CAPTCHAs are tricky. If the first attempt fails, running the same prompt again usually works.

Which AI Tools Work?

Install Once, Use Forever

pip install bharat-courts

bharat-courts install-skills

That one command gives you access to 25 High Courts, 700+ District Courts, and the Supreme Court of India. The SDK is open source, free, and MIT licensed.

Star it on GitHub if it saves you time. Contribute if you can make it better.

No more eCourts. No more CAPTCHAs. Just ask.