post https://api.instantpay.in/identity/company/lookup
The Fetch Profile API is designed to simplify access to detailed company information. By entering a Corporate Identification Number (CIN), you can retrieve comprehensive details about the specified company.
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
Parameter Name Type Requirement Description companyIdentityNumber String Mandatory CIN Number latitude String Mandatory Location Latitude longitude String Mandatory Location Longitude externalRef String Mandatory Unique Transaction Id consent String Mandatory It will be Y
curl http
curl --location 'https://api.instantpay.in/identity/company/lookup' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--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 'X-Ipay-Outlet-Id: {{outletID}}' \
--data '{
"companyIdentityNumber" : "U92100TN2015PTC102877",
"latitude" : "0.00",
"longitude" : "0.00",
"externalRef" : "djfodf",
"consent" : "Y"
}'
POST /identity/company/lookup HTTP/1.1
Host: api.instantpay.in
Accept: application/json
Content-Type: application/json
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825
X-Ipay-Endpoint-Ip: 45.115.105.205
X-Ipay-Outlet-Id: 72762
Content-Length: 159
{
"companyIdentityNumber" : "U92100TN2015PTC102877",
"latitude" : "0.00",
"longitude" : "0.00",
"externalRef" : "djfodf",
"consent" : "Y"
}
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
JSON
{
"statuscode": "TXN",
"actcode": null,
"status": "Data Fetched Successful",
"data": {
"poolReferenceId": "1230717101848FBSEZ",
"pool": {
"openingBal": "96186.73",
"amount": "5.90",
"closingBal": "96180.83"
},
"companyData": {
"fllpin": "FZZZ-9999",
"foreignLlpName": "Business Name",
"countryOfIncorporation": "IN",
"numberOfAuthorisedRepresentatives": "",
"dateOfIncorporation": "-",
"registeredAddress": "Full Address",
"emailId": "Email ID",
"typeOfOffice": "ROC",
"details": "",
"mainDivisionOfBusinessActivityToBeCarriedOutInIndia": "29",
"descriptionOfMainDivision": "Manufacture of machinery and equipment N.E.C.",
"dateOfLastFinancialYearEndDateForWhichStatementOfAccountsAndSolvencyFiled": "-",
"fllpStatus": "INACTIVE",
"directors": [
{
"dinPan": "05269777",
"name": "Sample Name",
"beginDate": "26/10/2012",
"endDate": "-",
"surrenderedDin": "NO"
},
{
"dinPan": "06378793",
"name": "Sample Name",
"beginDate": "26/10/2012",
"endDate": "-",
"surrenderedDin": "NO"
}
]
}
},
"timestamp": "2023-07-17 10:18:48",
"ipay_uuid": "h00099aa59f4-fabb-47fd-821c-b2d39ce2a858",
"orderid": "1230717101848FBSEZ",
"environment": "SANDBOX",
"internalCode": null
}
