High Court Case History API

The High Court Case History API provides complete historical details of court case proceedings and hearing activities. It allows users to retrieve information such as court name, sub court, CNR number, case number, case title, petitioner and respondent details, hearing dates, business purpose, adjournment reasons, next hearing purpose, upcoming hearing dates, and disposal information in a structured and easily accessible format.

API Details

Request URL

POST

https://g99.in/api/ecourt/case/hchistory

Request Body Parameters

Type	Name	Optional	Description
String	cnrNumber	Required	Unique court case tracking number.
String	date	Required	Relevant date associated with the case of bussiness date.

Sample Request Payload

request.json

{
  "cnrNumber": "HCMA010111112025",
  "date": "01-03-2025"
}

Request Header Parameters

Type	Name	Value / Description	Optional
String	Content-Type	application/json	Required

Sample Code

request.php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://g99.in/api/ecourt/case/hchistory',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "cnr": "HCMA010111112025",
  "date": "09-01-2024"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

request.py

import requests
import json

url = "https://g99.in/api/ecourt/case/hchistory"

payload = json.dumps({
  "cnr": "HCMA010111112025",
  "date": "09-01-2024"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

request.cs

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://g99.in/api/ecourt/case/hchistory");
var content = new StringContent("{\r\n  \"cnr\": \"HCMA010111112025\",\r\n  \"date\": \"09-01-2024\"\r\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

HTTP status code 200

Key	Type	Description
courtName	String	Name of the court handling the case.
subCourt	String	Name of the specific bench or sub court.
cnrNumber	String	Unique court case tracking number.
caseNumber	String	Official number assigned to the case.
caseName	String	Name/title of the case proceedings.
petitioner	String	Person or party who filed the case.
respondent	String	Person or party against whom the case is filed.
date	Date	Relevant date associated with the case.
business	String	Purpose or business listed for the hearing.
nextPurpose	String	Purpose of the upcoming hearing.
nextHearingDate	Date	Scheduled date for the next hearing.
natureOfDisposal	String	Type or manner of case disposal.
disposalDate	Date	Date on which the case was disposed.

Sample Response

Sample response for valid document

response.json

{
  "courtName": "Principal Bench of Madras High Court",
  "subCourt": "The Hon'ble Justice",
  "cnrNumber": "HCMA010111112025",
  "caseNumber": "CMP/0004273/2025",
  "caseName": "King General Insurance Co Ltd  Versus  R Guru",
  "petitioner": "King General Insurance Co Ltd",
  "respondent": "R Guru",
  "date": "13-03-2025",
  "business": "Adjournment",
  "reasonForAdjournment": "ADJOURNED",
  "nextPurpose": "TO DISPENSE WITH",
  "nextHearingDate": "01-03-2025",
  "disposalDate": "01-04-2025"
}

Error Response

Parameter	Type	Description
status	Number	Unique error codes for different errors. Always available.
message	String	Error message describing the error. Always Available.
error	Boolean	True / False for different errors. Always available.

Error Codes

HTTP Status	Error Code	Error Message
200	2001	No data found.
400	4001	Malformed data or missing required parameter values.
400	4002	Invalid CNR Number.
400	4003	Invalid CNR Number Type.
500	5001	Request could not be processed. Please try again later.

Sample Error Response

response.json

{
  "message": "Malformed data or missing required parameter values.",
  "status": 4001,
  "error": True
}