# ecourts

## Docs

- [Get case details for multiple CNR numbers (max 50)](https://docs-themis.neeved.com/api-reference/case-detail/get-case-details-for-multiple-cnr-numbers-max-50.md): Batch lookup for up to 50 CNR numbers in a single request. Returns found cases, a list of CNRs that were not found, and any that failed to process.
- [Get full case details by CNR number](https://docs-themis.neeved.com/api-reference/case-detail/get-full-case-details-by-cnr-number.md): Returns the complete case record for a single CNR number, including all parties, hearing schedule, legal references, and optional hearing history.
- [Request a fresh data sync for a case](https://docs-themis.neeved.com/api-reference/case-refresh/request-a-fresh-data-sync-for-a-case.md): Triggers a live pull from the source court system for a single case. Returns refreshStatus: skipped if the case was synced recently and force is not set.
- [Request a fresh data sync for up to 20 cases](https://docs-themis.neeved.com/api-reference/case-refresh/request-a-fresh-data-sync-for-up-to-20-cases.md): Batch refresh for up to 20 CNR numbers. Returns per-case outcomes including which cases changed, which were skipped, and which failed.
- [List all known judges from high court and supreme court](https://docs-themis.neeved.com/api-reference/case-search/list-all-known-judges-from-high-court-and-supreme-court.md): Returns the full list of judge names indexed by ecourts from high courts and the Supreme Court. Use these values in the judge field of case search to find all cases before a specific judge.
- [Search cases across district, high, and supreme courts](https://docs-themis.neeved.com/api-reference/case-search/search-cases-across-district-high-and-supreme-courts.md): Full-text search across all court types. At least one of petitioner, respondent, litigant, advocate, judge, filingNumber, or firNumber is required. Combine multiple filters to narrow results.
- [Full court hierarchy](https://docs-themis.neeved.com/api-reference/court-structure/full-court-hierarchy.md): Returns the complete nested hierarchy of all states, districts, and court complexes in a single response. Use this to bootstrap a local directory cache.
- [List all states with state codes](https://docs-themis.neeved.com/api-reference/court-structure/list-all-states-with-state-codes.md): Returns every state and union territory with its corresponding state code. Use state codes as path parameters in other court structure endpoints.
- [List court complexes within a district](https://docs-themis.neeved.com/api-reference/court-structure/list-court-complexes-within-a-district.md): Returns all court complexes in a district with address and geolocation where available.
- [List districts within a state](https://docs-themis.neeved.com/api-reference/court-structure/list-districts-within-a-state.md): Returns all districts in a given state with their district codes.
- [List individual courts within a complex](https://docs-themis.neeved.com/api-reference/court-structure/list-individual-courts-within-a-complex.md): Returns all individual courts or benches within a court complex, including the presiding judge where available.
- [API Reference](https://docs-themis.neeved.com/api-reference/introduction.md): Complete reference for all ecourts API endpoints.
- [Credits & Billing](https://docs-themis.neeved.com/credits-and-billing.md): Understand how API usage is metered and how to manage your credit balance.
- [Getting Started](https://docs-themis.neeved.com/getting-started.md): Create your API key and make your first request in under five minutes.
- [Authentication](https://docs-themis.neeved.com/guides/authentication.md): How to authenticate requests to the ecourts API.
- [Error Codes](https://docs-themis.neeved.com/guides/error-codes.md): HTTP status codes and error response format used by the ecourts API.
- [Pagination](https://docs-themis.neeved.com/guides/pagination.md): How to page through large result sets in the ecourts API.
- [Rate Limits](https://docs-themis.neeved.com/guides/rate-limits.md): Request limits per API key and how to handle 429 responses.
- [Roles](https://docs-themis.neeved.com/roles.md): Every account is assigned one of three roles that controls platform access and API key permissions.
- [Welcome](https://docs-themis.neeved.com/welcome.md): Programmatic access to Indian court case data across district courts, high courts, and the Supreme Court.

## OpenAPI Specs

- [openapi](https://docs-themis.neeved.com/openapi.json)