get https://api.instantpay.in/identity/lei
A Legal Entity Identifier (LEI) is a unique 20-character alphanumeric code used to identify distinct legal entities that engage in financial transactions. The LEI is part of a global initiative to improve the transparency and stability of the financial system by enabling clear and precise identification of parties involved in financial transactions.
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 |
|---|---|---|---|
| value | String | Mandatory | Unique ID of LEI which consists of 20 Characters Alpha Numeric code |
| type | String | Mandatory | Type can be NAME,BIC,ISIN,LEI |
| pagination[pageNumber] | Array | Optional | Number of Pages |
| pagination[recordsPerPage] | Array | Optional | Records per pages |
| externalRef | String | Mandatory | Your Unique Transaction id |
| latitude | String | Mandatory | End Customer Latitude. |
| longitude | String | Mandatory | End Customer Longitude |
Sample Request
curl --location --globoff 'https://api.instantpay.in/identity/lei?latitude=-28.9976&longitude=112.1961&externalRef=1716870299&type=LEI&value=335800ZS5FFXU1CGRK27&pagination[pageNumber]=1&pagination[recordsPerPage]=10' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208df87f3000aa5b56fc926d1' \
--header 'X-Ipay-Endpoint-Ip: 14.142.186.142'
GET /identity/lei?latitude=-42.3272&longitude=-93.4232&externalRef=1716870350&type=LEI&value=335800ZS5FFXU1CGRK27&pagination[pageNumber]=1&pagination[recordsPerPage]=10 HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208df87f3000aa5b56fc926d1
X-Ipay-Endpoint-Ip: 14.142.186.142
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": {
"poolReferenceId": "1240527171547ZXLPN",
"pool": {
"openingBal": "43.42",
"mode": "DR",
"amount": "2.36",
"closingBal": "41.06"
},
"meta": {
"totalPages": 1,
"currentPage": 1,
"totalRecords": 1,
"recordsOnCurrentPage": 10,
"recordFrom": 1,
"recordTo": 1
},
"record": [
{
"lei": "335800ZS5FFXU1CGRK27",
"entity": {
"legalName": {
"name": "ANKIT INTERNATIONAL",
"language": "en"
},
"otherNames": [],
"transliteratedOtherNames": [],
"legalAddress": {
"language": "en",
"addressLines": [
"42/42",
"WEST PUNJABI BAGH"
],
"addressNumber": null,
"addressNumberWithinBuilding": null,
"mailRouting": null,
"city": "NEW DELHI",
"region": "IN-DL",
"country": "IN",
"postalCode": "110026"
},
"headquartersAddress": {
"language": "en",
"addressLines": [
"42/42",
"WEST PUNJABI BAGH"
],
"addressNumber": null,
"addressNumberWithinBuilding": null,
"mailRouting": null,
"city": "NEW DELHI",
"region": "IN-DL",
"country": "IN",
"postalCode": "110026"
},
"registeredAt": {
"id": "RA000709",
"other": null
},
"registeredAs": "0509049290",
"jurisdiction": "IN",
"category": "GENERAL",
"legalForm": {
"id": "A0PS",
"other": null
},
"associatedEntity": {
"lei": null,
"name": null
},
"status": "INACTIVE",
"expiration": {
"date": null,
"reason": null
},
"successorEntity": {
"lei": "3358004PT3NRFB1FYG32",
"name": null
},
"successorEntities": [
{
"lei": "3358004PT3NRFB1FYG32"
}
],
"creationDate": null,
"subCategory": null,
"otherAddresses": [],
"eventGroups": [
{
"groupType": "STANDALONE",
"events": [
{
"validationDocuments": "OTHER_OFFICIAL_DOCUMENTS",
"effectiveDate": "2021-02-18T06:17:13Z",
"recordedDate": "2021-02-18T06:17:13Z",
"type": "MERGERS_AND_ACQUISITIONS",
"status": "COMPLETED",
"affectedFields": [
{
"value": "3358004PT3NRFB1FYG32",
"xpath": "/lei:LEIData/lei:LEIRecords/lei:LEIRecord/lei:Entity/lei:SuccessorEntity/lei:SuccessorLEI"
}
]
}
]
}
]
},
"registration": {
"initialRegistrationDate": "2019-03-14T12:57:51Z",
"lastUpdateDate": "2022-03-11T13:30:01Z",
"status": "RETIRED",
"nextRenewalDate": "2021-03-13T18:30:00Z",
"managingLou": "335800FVH4MOKZS9VH40",
"corroborationLevel": "FULLY_CORROBORATED",
"validatedAt": {
"id": "RA000709",
"other": null
},
"validatedAs": "0509049290",
"otherValidationAuthorities": [
{
"validatedAt": {
"id": "RA888888"
},
"validatedAs": "0509049290"
}
]
},
"bic": null,
"mic": null,
"ocid": null,
"spglobal": [
"606978683"
],
"conformityFlag": "NOT_APPLICABLE"
}
]
},
"timestamp": "2024-05-27 17:15:47",
"ipay_uuid": "h0059c249b12-fce2-4b1b-a804-eb4ee9ca30e3-KewJUzvBST1G",
"orderid": "1240527171547ZXLPN",
"environment": "LIVE"
}