post
https://api.instantpay.in/identity/verifyPassport
This API Fetch the user passport details using the Application Number and Date of Birth (DOB) to securely verify the passport status and related information in real time from the issuing authority.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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 |
|---|---|---|---|
| passportFileNumber | String | Mandatory | Passport Number |
| dob | String | Mandatory | Passport holder's date of birth |
| 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/verifyPassport' \
--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 '{
"passportFileNumber": "GZ606xxx4976225",
"dob": "1999-02-22",
"latitude": "28.5245",
"longitude": "77.2688",
"externalRef": "1764061199"
}POST /identity/verifyPassport HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: xxxxxxxxxxxxxxxx
X-Ipay-Client-Secret: xxxxxxxxxxxxxxxx
X-Ipay-Endpoint-Ip: xxxxxxxxxxxxxx
Content-Type: application/json
Content-Length: 139
{
"passportFileNumber": "GZ6066204976225",
"dob": "1999-02-22",
"latitude": "28.5245",
"longitude": "77.2688",
"externalRef": "1764061199"
}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": {
"passportData": {
"passportFileNumber": "GZ606xxx4976225",
"dob": "22/02/1999",
"passportNumber": null,
"name": "John",
"surname": "Doe",
"applicationType": "Normal",
"applicationDate": "17/11/2025",
"dateOfDispatch": null
},
"poolReferenceId": "1251127173134EZFJY",
"pool": {
"openingBal": "11.13",
"mode": "DR",
"amount": "2.36",
"closingBal": "8.77"
}
},
"timestamp": "2025-11-27 17:31:34",
"ipay_uuid": "h000a0750700-f103-4e99-b590-b6af7be51727-TztOuvmr0eDo",
"orderid": "1251127173134EZFJY",
"environment": "LIVE",
"internalCode": null
}