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 Unified Court Cases Details API. 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

Get Free Trial

Create a free account Or “Talk to Us” for price information and other queries.

Talk to us Create free account

API Details

Request

Type	URL
GET	`https://api.attestr.com`/api/`{version}`/public/ecourtx/case-types?courtType=<courtType>

Request Header Parameters

Type	Name	Value / Description	Optional	Min Version	Max Version
String	Content-Type	application/json	Required	v1
String	Authorization	Basic `{authToken}`	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

RequestUrl
    
 
https://api.attestr.com/api/v2/public/ecourtx/case-types?courtType=NCLT
Copy

Response

HTTP status code 200

Key	Description	Type	Min 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

JSON
    
 
[    {        "state": null,        "court": "DRAT",        "bench": "DEBT RECOVERY APPELLATE TRIBUNAL - ALLAHABAD",        "establishmentCode": "DAL",        "caseTypes": [            {                "name": "REGULAR APPEAL",                "code": "REGULAR APPEAL"            },            {                "name": "MISC APPEAL",                "code": "MISC APPEAL"            },            {                "name": "IA",                "code": "IA"            }        ]    },    {        "state": null,        "court": "DRAT",        "bench": "DEBT RECOVERY APPELLATE TRIBUNAL - CHENNAI",        "establishmentCode": "DAL",        "caseTypes": [            {                "name": "REGULAR APPEAL",                "code": "REGULAR APPEAL"            },            {                "name": "MISC APPEAL",                "code": "MISC APPEAL"            },            {                "name": "IA",                "code": "IA"            }        ]    }]
Copy

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

JSON
    
 
{  "code": 4001,  "message": "Malformed data or missing required parameter values"}
Copy

Get Free Trial

Create a free account Or “Talk to Us” for price information and other queries.

Talk to us Create free account

Last updated on