# NeevLegal

- [Welcome](https://docs-neevlegal.neeved.com/welcome.md): Programmatic access to Indian court case data across district courts, high courts, and the Supreme Court.
- [Roles](https://docs-neevlegal.neeved.com/roles.md): Every account is assigned one of three roles that controls platform access and API key permissions.
- [Getting Started](https://docs-neevlegal.neeved.com/getting-started.md): Create your API key and make your first request in under five minutes.
- [Credits & Billing](https://docs-neevlegal.neeved.com/credits-and-billing.md): Understand how API usage is metered and how to manage your credit balance.
- [Authentication](https://docs-neevlegal.neeved.com/guides/authentication.md): How to authenticate requests to the NeevLegal API.
- [Pagination](https://docs-neevlegal.neeved.com/guides/pagination.md): How to page through large result sets in the NeevLegal API.
- [Rate Limits](https://docs-neevlegal.neeved.com/guides/rate-limits.md): Request limits per API key and how to handle 429 responses.
- [Error Codes](https://docs-neevlegal.neeved.com/guides/error-codes.md): HTTP status codes and error response format used by the NeevLegal API.
- [API Reference](https://docs-neevlegal.neeved.com/api-reference/introduction.md): Complete reference for all NeevLegal API endpoints.
- [Search cases across district, high, and supreme courts](https://docs-neevlegal.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 litigant, petitioner, respondent, advocate, judge, filingNumber, or firNumber is required. Combine multiple filters to narrow results.
- [List all known judges from high court and supreme court](https://docs-neevlegal.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 NeevLegal 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.
- [Get full case details by CNR number](https://docs-neevlegal.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 hearing history.
- [Get case details for multiple CNR numbers (max 50)](https://docs-neevlegal.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.
- [Full court hierarchy](https://docs-neevlegal.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-neevlegal.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 districts within a state](https://docs-neevlegal.neeved.com/api-reference/court-structure/list-districts-within-a-state.md): Returns all districts in a given state with their district codes.
- [List court complexes within a district](https://docs-neevlegal.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 individual courts within a complex](https://docs-neevlegal.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.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.