Search Court Cases
ecourts_search_casesSearch Indian court cases using text queries, filters, date ranges, and year filters. Returns matching cases with CNR, parties, dates, and facet counts.
Instructions
Search for Indian court cases with text queries, filters, date ranges, year filters, and faceted aggregations.
Text search args (all optional): query, advocates, judges, petitioners, respondents, litigants
Filter args (arrays): court_codes, case_types, case_statuses, judicial_sections, case_categories, bench_types
Year filters (integer arrays): filing_years, registration_years, first_hearing_years, next_hearing_years, decision_years
Date ranges (YYYY-MM-DD): filing_date_from/to, registration_date_from/to, first_hearing_date_from/to, next_hearing_date_from/to, decision_date_from/to
Controls: include_facet_counts (bool), sort_by, sort_order, page, page_size (max 100)
Returns: matching cases with CNR, parties, dates, facet counts. Supply at least one search term or filter.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (1-based) | |
| query | No | General full-text search across all fields | |
| judges | No | Search by judge name | |
| sort_by | No | Field to sort by | |
| advocates | No | Search by advocate name (both petitioner and respondent advocates) | |
| litigants | No | Search petitioners AND respondents simultaneously | |
| page_size | No | Results per page (max 100) | |
| case_types | No | Filter by case types: CIVIL, CRIMINAL, WRIT, APPEAL, REVISION, EXECUTION, ARBITRATION, MATRIMONIAL, MOTOR_ACCIDENT, LABOR | |
| sort_order | No | Sort direction | |
| bench_types | No | Filter by bench type, e.g. ['SINGLE','DIVISION'] | |
| court_codes | No | Filter by court codes, e.g. ['DLHC01','HCBM01']. Use ecourts_get_court_structure or the enum reference. | |
| petitioners | No | Search by petitioner name | |
| respondents | No | Search by respondent name | |
| filing_years | No | Filter by filing year(s), e.g. [2024, 2023] | |
| case_statuses | No | Filter by statuses: PENDING, DISPOSED, TRANSFERRED, WITHDRAWN, UNKNOWN | |
| decision_years | No | Filter by decision year(s) | |
| filing_date_to | No | Filing date range end (YYYY-MM-DD) | |
| case_categories | No | Filter by case categories, e.g. ['COMMERCIAL'] | |
| decision_date_to | No | Decision date range end (YYYY-MM-DD) | |
| filing_date_from | No | Filing date range start (YYYY-MM-DD) | |
| judicial_sections | No | Filter by judicial sections: CIV, CRIM, WRIT, REV, APP, MISC, PIL, BAIL, URG, ADM | |
| decision_date_from | No | Decision date range start (YYYY-MM-DD) | |
| next_hearing_years | No | Filter by next hearing year(s) | |
| registration_years | No | Filter by registration year(s) | |
| first_hearing_years | No | Filter by first hearing year(s) | |
| include_facet_counts | No | Include facet (aggregation) counts in response. Default true. | |
| next_hearing_date_to | No | Next hearing date range end (YYYY-MM-DD) | |
| registration_date_to | No | Registration date range end (YYYY-MM-DD) | |
| first_hearing_date_to | No | First hearing date range end (YYYY-MM-DD) | |
| next_hearing_date_from | No | Next hearing date range start (YYYY-MM-DD) | |
| registration_date_from | No | Registration date range start (YYYY-MM-DD) | |
| first_hearing_date_from | No | First hearing date range start (YYYY-MM-DD) |