Detailed Court Case Check - Result
Overview
The objective of this API system is to provide a comprehensive, legally attested court case report for any individual, in a secure and efficient manner. The API enables users to initiate a court case check request and retrieve an official report—reviewed and attested by a licensed lawyer—within a timeframe of 2 to 24 hours.
This system ensures trust, traceability, and compliance with legal verification requirements across sectors like fintech, employment, due diligence, legal services, and identity verification.
This is second step in genereating a detailed court case report.
Sample report: https://persist.signzy.tech/api/files/1241177678/download/81164939581f4b178485af46052e530340537cc4c9e24fcfa98715703684b1e2.pdf
Curl
curl --location 'https://api.signzy.app/api/v3/detailedCourtCaseCheckAPI-Result' \
--header 'Authorization: XXXX' \
--header 'Content-Type: application/json' \
--data '{
"verifyId" : ""
}Input Parameters
Parameter | Description / Format | Required/Optional |
|---|---|---|
verifyId | String | required |
Output Response
{
"statusMsg": "Report is Ready",
"idc": 1,
"name": "Vivek Mishra",
"addresses": [
{
"address": "\\* 4013 Tinka"
}
],
"matchedCaseDetails": [
{
"_id": "Id",
"address": "Tinka",
"businessCategory": "pending warrants",
"caseCategory": "criminal",
"caseCode": "200102309872017",
"caseStatus": "Disposed",
"caseType": "Disposed",
"caseTypeDescription": "",
"caseYear": "2017",
"courtCode": 10,
"courtName": "Additional Metropolitan Magistrate, Mazgaon, Mumbai",
"decisionDate": " 24th August 2017",
"distCode": 23,
"distName": "Mumbai CMM Courts",
"firNo": "FirNo ",
"firstHearingDate": "24th August 2017",
"id": null,
"isDistrict": 0,
"isState": 0,
"link": "sample Link",
"matchedAddress": null,
"matchedName": "Vivek Mishra",
"maxWordsMatched": 2,
"md5": "e8ba870fb6b04ed6d2f260daf068ab4a",
"nameScore": 100,
"natureOfDisposal": " Uncontested--Disposed Under Sec 258 Cr.P.C.",
"policeStation": "PYDHONIE POLICE STATION",
"purposeOfHearing": null,
"score": 45,
"source": "ecourt",
"stateCode": 1,
"stateName": "Maharashtra",
"totalNameMatch": 2,
"type": 1,
"underActs": "Maharashtra Police Act",
"underSections": "102,117",
"uniqCaseId": "7e36cb46865afc6199e1c86124e20b24",
"verifycode": "CAEA",
"wordsMatched": [],
"year": "2017",
"nlj": 1,
"typeText": "respondant",
"autoReport": "g",
"ref": "5e68cf4594ff5652ea347749",
"addressRef": "5e68d17b95798c0007ebc9ee",
"sectioninfo": null,
"nextHearingDate": null,
"isBail": false,
"caseDate": null,
"regNo": 0,
"regDate": null,
"filingDate": null,
"manualClientQc": "r",
"editor": "editorName",
"editionTime": "2020-03-11T11:56:45.180Z",
"courtComplexName": "Metropolitan Magistrates Court, 9 Acharya Donde Marg, Gandhi Nagar, Sewree (W), Mumbai. Mumbai CMM Courts"
}
],
"reportUrl": "http://**.**\\*.\\*.**/**\\*_Vivek_Mishra_1.pdf"
}
Output Parameters
Report Not Ready
Field | Description | Type |
|---|---|---|
statusMsg | Message stating the report is not ready. Example: "Report is Not Ready" | String |
Green Case
Field | Description | Type |
|---|---|---|
statusMsg | Success message indicating report was successfully generated. | String |
verifyId | Unique ID for verification request. | String |
name | Name of the individual verified. | String |
address | Array of address strings (usually a single address). | Array[String] |
report | Report status indicator, "green" means no matched legal/criminal cases. | String |
matchedCaseDetails | Empty array indicating no matched cases. | Array |
reportUrl | Persist URL to view or download the generated report PDF. | String |
Red Case
Field | Description | Type |
|---|---|---|
statusMsg | Status message indicating the report is ready. Example: "Report is Ready" | String |
idc | Internal ID associated with the report. | Number |
name | Name of the individual being verified. | String |
addresses | Array of address objects. Each contains a single address field. | Array[Object] |
matchedCaseDetails | Array of case objects. Each object contains detailed information. | Array[Object] |
id | Internal case record ID. | String |
address | Address linked to the legal case. | String |
businessCategory | Nature of the issue (e.g., "pending warrants"). | String |
caseCategory | Category of case (e.g., "criminal"). | String |
caseCode | Unique identifier for the case. | String |
caseStatus | Status of the case (e.g., "Disposed"). | String |
caseType | Type of case. Often overlaps with caseStatus. | String |
caseTypeDescription | Additional description of the case type. | String |
caseYear | Year the case was filed. | String |
courtCode | Code representing the court. | Number |
courtName | Full name of the court. | String |
decisionDate | Date of final decision/judgment. | String |
distCode | District code of the court. | Number |
distName | Name of the district where the case was registered. | String |
firNo | FIR (First Information Report) number. | String |
firstHearingDate | Date of the first hearing. | String |
id | Case-related ID (can be null). | String/Null |
isDistrict | Indicator (0/1) if it's a district-level case. | Number |
isState | Indicator (0/1) if it's a state-level case. | Number |
link | URL or reference to the original source/case entry. | String |
matchedAddress | Address that matched during verification (can be null). | String/Null |
matchedName | Name matched with the verification request. | String |
maxWordsMatched | Number of words matched from the input. | Number |
md5 | Hash used for verifying data integrity. | String |
nameScore | Name similarity score (0–100). | Number |
natureOfDisposal | How the case was disposed (e.g., "Disposed Under Sec 258 Cr.P.C."). | String |
policeStation | Police station where the FIR was filed. | String |
purposeOfHearing | Purpose of the hearing (can be null). | String/Null |
score | Match score between input and case details. | Number |
source | Data source (e.g., "ecourt"). | String |
stateCode | Code representing the state. | Number |
stateName | Full name of the state. | String |
totalNameMatch | Total number of name parts that matched. | Number |
type | Internal type indicator (e.g., 1). | Number |
underActs | Law(s)/Acts under which the case was filed. | String |
underSections | Legal sections associated with the case. | String |
uniqCaseId | Unique identifier for the case. | String |
verifycode | Code used internally for verification mapping. | String |
wordsMatched | Array of words that matched during verification (often empty). | Array |
year | Case year (redundant with caseYear). | String |
nlj | Possibly stands for legal journal/category flag. | Number |
typeText | Role of the individual in the case (e.g., "respondent"). | String |
autoReport | Reporting status (e.g., "g" for generated). | String |
ref | Reference ID linking back to master records. | String |
addressRef | ID referencing address records. | String |
sectioninfo | Section-level details (can be null). | String/Null |
nextHearingDate | Date of the next hearing (if available). | String/Null |
isBail | Boolean flag indicating if bail was granted. | Boolean |
caseDate | Case registration date (can be null). | String/Null |
regNo | Case registration number. | Number |
regDate | Date when case was officially registered. | String/Null |
filingDate | Filing date of the case. | String/Null |
manualClientQc | QC flag used internally (e.g., "r" for red). | String |
editor | Name of the person who reviewed or edited the record. | String |
editionTime | Timestamp when the record was last updated. | String |
courtComplexName | Name and location of the court complex. | String |
reportUrl | Persist URL to view or download the report. | String |
Status Code
HTTP Codes | Explanation |
|---|---|
200 | process complete |
302 | Report is not ready |
401 | Authentication Failed |
404 | Report not found |
409 | Upstream Error |
500 | Some Error occured at our side please try again later |