post https://api.instantpay.in/identity/litigation
Look up litigation data from District Courts, High Courts, Supreme Court, digitized FIR records. Available for both individual and commercial entities.
Header Parameters
| Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
|---|---|---|---|---|
| X-Ipay-Auth-Code | String | Auth Code is "1" (Fixed) | M | Y |
| X-Ipay-Client-Id | String | Unique Client Id Provided by Instantpay | M | Y |
| X-Ipay-Client-Secret | String | Unique Client Secret Provided by Instantpay | M | Y |
| X-Ipay-Endpoint-Ip | String | End customer IP Address | M | Y |
Request Parameters
| Parameter Name | Type | Requirement | Description |
|---|---|---|---|
| name | String | Mandatory | Name of the Entity/Individual |
| fatherName | String | Optional (Mandatory when searchType is Individual) | Father Name of the Individual |
| searchType | String | Mandatory | It will be either Entity or Individual |
| address | String | Mandatory | Address of the Entity or Individual |
| latitude | String | Mandatory | End Customer Latitude. |
| longitude | String | Mandatory | End Customer Longitude |
| externalRef | String | Mandatory | Your Unique Transaction id |
Sample Request
curl --location 'https://api.instantpay.in/identity/litigation' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data '{
"name": "Name of the entity/individual",
"fatherName": "Father Name",
"searchType": "Individual",
"address": "Address",
"latitude": "11.10",
"longitude": "26.91",
"externalRef": "17324678223"
},
POST /identity/litigation HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: 14.142.186.142
Content-Type: application/json
Content-Length: 234
{
"name": "Name of the entity/individual",
"fatherName": "Father Name",
"searchType": "Individual",
"address": "Address",
"latitude": "11.10",
"longitude": "26.91",
"externalRef": "17324678223"
}
Response Parameters
| Parameter Name | Type | Description |
|---|---|---|
| statuscode | String | Instantpay Status Code |
| actcode | String | Action Code |
| status | Array | Status message |
| data | String | Response Data(if Present) |
| timestamp | String | Response time (YYYY-MM-DD HH:II:SS) |
| ipay_uuid | String | Request reference number |
| orderid | String | Transaction Id(if transaction otherwise it is null) |
| environment | String | Live/Sandbox |
| internalCode | String | It will be null |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"externalRef": "1739249676",
"poolReferenceId": "1250211102436SXJAZ",
"txnReferenceId": "1790435672",
"pool": {
"account": "983512345",
"openingBal": "24.45",
"mode": "DR",
"amount": "0.00",
"closingBal": "24.45"
},
"litigationDetails": [
{
"address": "DUTARWALI TEHSIL ABHOR DIST FAZILKA",
"addressDistCode": "00280006",
"addressDistrict": "Fazilka",
"addressPincode": "",
"addressState": "Punjab",
"addressStateCode": "0028",
"addressStreet": "dutarwali abhor",
"addressTaluka": "fazilka",
"algoRisk": "",
"allCandidates": [
"state of punjab"
],
"businessCategory": "Serious",
"caseCategory": "criminal",
"caseCode": "202500004482016",
"caseDecisionDate": "",
"caseFilter": "POLICE_CASE",
"caseNo": "202500004482016",
"caseNoYear": "",
"caseStatus": "",
"caseType": "BA",
"caseTypeCode": "25",
"caseTypeName": "BA - BAIL APPLICATION",
"caseYear": "2016",
"cleanName": "Individual Name",
"cnr": "",
"courtCode": 13,
"courtComplexCode": "1220012",
"courtName": "Addl District and Sessions Judge,Taluka Court Mohali",
"courtNoAndJudge": "5-Additional District and Sessions Judge",
"courtNoJudge": "",
"courtNoName": "",
"courtNumberAndJudge": "5-Additional District and Sessions Judge",
"customDistCode": "00280019",
"customStateCode": "0028",
"dataCategory": "imprisonment The_Code_of_Criminal_Procedure__1973 The_Code_of_Criminal_Procedure__Amendment__Act__1980 The_Code_of_Civil_Procedure__1908 The_Goa__Daman_and_Diu__Extension_of_the_Code_of_Civil_Procedure_and_the_Arbitration_Act__Act__1965 439",
"decisionDate": "",
"distCode": 3,
"distName": "Rupnagar",
"fatherMatchType": "NO_MATCH",
"fileYear": "",
"filingDate": "31-03-2016",
"filingDateNew": "",
"filingNo": "738/2016",
"filingNoNew": "",
"fine": "No fine",
"firNo": "77",
"firYear": "2010",
"firstHearingDate": "01st April 2016",
"globalCategory": "police",
"gogreenFatherNameScore": 0,
"id": "d7845da96b186a333cd661833b51d3ca",
"imprisonment": "No imprisonment",
"link": "https://verify24x7.in/live/casehtml3.php?link=https%3A%2F%2Ffullhtml.s3-us-west-2.amazonaws.com%2F719f658d87df7cd1f3164550db27099e&id=22-3-13",
"md5": "719f658d87df7cd1f3164550db27099e",
"modelScore": 1.4828503,
"name": "LAWERENCE BISHNOI",
"nameMatchType": "EXACT_FUZZY",
"natureOfDisposal": "",
"nextHearingDate": "03rd May 2016",
"oparty": "STATE OF PUNJAB",
"orderSummary": "The case status is unknown",
"policeStation": "Phase 8",
"purposeOfHearing": " Appearance",
"rawAddress": " - DUTARWALI TEHSIL ABHOR DIST FAZILKA",
"ref": "409e18bfe7a0414d846f0fe9494f4da7",
"registrationDate": "01-04-2016",
"registrationDateNew": "",
"registrationNo": "448/2016",
"registrationNoNew": "",
"score": 98.1,
"source": "ecourt",
"stageOfCase": "Appearance",
"stateCode": 22,
"stateName": "Punjab",
"subject": "",
"timeStamp": "2022-05-03T09:59:23.593611",
"type": 0,
"underActs": "Code of Criminal Procedure, 1973",
"underSections": "439",
"uniqCaseId": "d7845da96b186a333cd661833b51d3ca",
"year": "2010"
}
]
},
"timestamp": "2025-02-11 10:24:44",
"ipay_uuid": "h0009e2f0fe9-e653-4a43-b335-065ee52f5ee3-UQ5ZOLsxWnU2",
"orderid": "1250211102436SXJAZ",
"environment": "LIVE",
"internalCode": null
}
Consent Text :
I hereby give my consent and submit voluntarily at my own discretion, my Voter ID for the
purpose of establishing my identity on the portal. The Voter ID submitted herewith shall not be used for
any purpose other than mentioned, or as per the requirements of the law.