Title
Create new category
Edit page index title
Edit category
Edit link
Unified Case Types And Court Establishments API
API TO FETCH BENCH, COURT COMPLEXES AND CASE TYPES
Introduction
This helper API provides reference data required to use the Monitor Daily Court Case Updates - All Indian Courts, One Integration. It returns the supported establishmentCodes, caseTypes, and other metadata used across different court systems.
Since these values vary by court type, this API allows developers to dynamically fetch the valid parameters before making requests to the Unified Court Case Details API. Using this endpoint ensures that your integration always uses the latest supported court establishments and case type values.
Typical Use Cases:
Retrieve valid establishmentCodes for a specific court type
Get supported caseTypes for different courts
Ensure correct parameters when calling the Unified Court Case Details API
Build dynamic dropdowns or validation in court case search applications
API Details
Request
Type | URL |
|---|---|
GET | https://api.attestr.com/api/ |
Request Header Parameters
Type | Name | Value / Description | Optional | Min Version | Max Version |
|---|---|---|---|---|---|
String | Content-Type | application/json | Required | v1 | |
String | Authorization | Basic | Required | v1 |
If you do not have the authentication token, please refer to Register App to generate one.
Request URL Parameters
Name | Description | Min Version | Max Version |
|---|---|---|---|
courtType | Following are the allowed values. DC, HC, SC, CC, NCLT, NCLAT, GSTAT, DRT, DRAT DC - District Courts HC - High Courts SC - Supreme Court CC - eJagriti Consumer Court NCLT - National Company Law Tribunal NCLAT - National Company Law Appellate Tribunal GSTAT - GST Appellate Tribunal DRT - Debt Recovery Tribunal DRAT - Debt Recovery Appellate Tribunal | v2 |
Sample Request
Response
HTTP status code 200
Key | Description | Type | Min Version | Max Version |
|---|---|---|---|---|
state | Name of the state. Generally returned for district courts only. | String | v2 | |
court | Name of the court | ContactServiceTypeEnum | v2 | |
bench | Bench / Establishment name | Boolean | v2 | |
establishmentCode | Establishment code which should be passed in the establishmentCode field in the unified case details API | Boolean | v2 | |
caseTypes | Array of case types. Each object in the array has two fields. name - Case type name code - Case type code to be passed in the input to Unified case details API | String | v2 |
Sample Response
Sample response for valid contact number
Error Response
Parameter | Type | Description |
|---|---|---|
code | Number | Unique error codes for different errors. Always available. |
message | String | Error message describing the error. Always Available. |
details | String | Detail error message. Available only for certain types of errors. |
Error Codes
HTTP Status | Error Code | Error Message |
|---|---|---|
400 | 4001 | Malformed data or missing required parameter values |
400 | 4005 | Operation could not be performed due to low credits balance |
401 | 4016 | Invalid client authorization |
403 | 4031 | Unauthorized access |
403 | 4035 | Requested service is not provisioned for your account |
403 | 4039 | Client's IP address is not whitelisted |
403 | 4035 | Requested service is not provisioned for your account |
429 | 4291 | Maximum account rate limit exceeded |
429 | 4292 | Maximum API rate limit exceeded |
429 | 4293 | Maximum account daily limit exceeded |
429 | 4294 | Maximum API daily limit exceeded |
500 | 5001 | Request could not be processed |
Sample Error Response
Copyright © Attestr