Skip to main content
POST
/
case-search
Error
A valid request URL is required to generate request examples
{
  "success": true,
  "response": {
    "totalCount": 42,
    "page": 1,
    "limit": 10,
    "pages": 5,
    "cases": [
      {
        "cnrNumber": "MHPN010123456789",
        "caseStatus": "Pending",
        "court": {
          "stateName": "Maharashtra",
          "stateCode": "MH",
          "districtName": "Pune",
          "districtCode": "PUNE",
          "courtName": "Civil Court, Pune"
        },
        "petitioners": [
          {
            "partyName": "John Doe",
            "advocateName": "<string>"
          }
        ],
        "respondents": [
          {
            "partyName": "<string>",
            "advocateName": "<string>"
          }
        ],
        "nextHearingDate": "<string>",
        "nextHearingPurpose": "<string>",
        "caseType": "CS",
        "caseNumber": "CS/12/2023",
        "filingDate": "01-01-2023",
        "year": 2023,
        "filingNumber": "<string>",
        "registrationNumber": "<string>",
        "registrationDate": "<string>",
        "decisionDate": "<string>",
        "natureOfDisposal": "<string>",
        "category": "<string>"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
petitioner
string

Search by petitioner or applicant name. Minimum 3 characters.

Minimum string length: 3
​
respondent
string

Search by respondent or defendant name. Minimum 3 characters.

Minimum string length: 3
​
litigant
string

Search by name on either side of the case. Minimum 3 characters.

Minimum string length: 3
​
advocate
string

Search by advocate name appearing for any party. Minimum 3 characters.

Minimum string length: 3
​
judge
string

Search by presiding judge name. Minimum 2 characters.

Minimum string length: 2
​
filingNumber
string

Search by the provisional filing number assigned at submission.

​
caseType
string

Filter by court case type code — for example, CS, WP, or CC.

​
year
integer

Filter by the year in which the case was filed.

​
firNumber
string

Search criminal cases by FIR number.

​
policeStation
string

Filter criminal cases by police station name.

​
state
string

Limit results to a specific state using its state code — for example, MH.

​
district
string

Limit results to a specific district using its district code.

​
status
enum<string>

Filter by case lifecycle state.

Available options:
pending,
disposed,
all
​
filingDateFrom
string

Return only cases filed on or after this date. Format: DD-MM-YYYY.

​
filingDateTo
string

Return only cases filed on or before this date. Format: DD-MM-YYYY.

​
decisionDateFrom
string

Return only cases decided on or after this date. Format: DD-MM-YYYY.

​
decisionDateTo
string

Return only cases decided on or before this date. Format: DD-MM-YYYY.

​
sortBy
enum<string>

Field to sort results by.

Available options:
year,
filingDate,
registrationDate,
decisionDate
​
sortOrder
enum<string>

Sort direction.

Available options:
asc,
desc
​
page
integer

Page number to retrieve, starting from 1.

Required range: x >= 1
​
perPage
integer

Number of results per page. Maximum 50.

Required range: 1 <= x <= 50

Response

Paginated search results

​
success
boolean
required
Example:

true

​
response
object
required