Request Method :: POST

Description: The Passport Verification API verifies the authenticity of a Passport.

Headers

---

Content-Type: application/JSON

header_secrets:  To be shared during integration by ISU Team

pass_key:  To be shared during integration by ISU Team

Request Body Parameters

Parameters	Parameter description with validations and examples	Data type	Mandatory/Optional
fileNumber	Passport Number E.g-NG1064964059420	String	Mandatory
dob	Date of Birth of the passportholder E.g. - 02/07/1995	Date	Mandatory

Sample Request Body

---

{ "fileNumber": "NG1064964059420", "dob": "02/07/1995" }

Encrypted Sample Request Body

---

{ "RequestData": " vYK942PIjdCzQQGOY9polPx7RogzKDqVIycX3Qeddtz8KgMr+4jKVp8yz4dkyZBvUYoQ0lWJMfRIh4QqNpj kL/0y8J2HScJdYULXPwyiRKg=" }

Response Body Parameters

Parameters	Parameter description with examples	Data type
statusCode	Status code of the response	Integer
status	Status message of the response	String
statusDesc	Description of the status	string
data	Contains the main response data	String
result	Result of the API response	String
fileNumber	Passport file number	String
givenName	Applicant’s given name	String
surname	Applicant’s surname	String
typeOfApplication	Type of passport application (e.g., NORMAL)	String
applicationReceivedOnDate	Date when the application was received	String
name	Full name of the applicant	string
dob	Date of birth of the applicant	string
error	Name of the error (Only for FAILED)	String
message	Error message (Only for FAILED)	string
reason	Reason for Error (Only for FAILED)	String
type	Type of error (Only for FAILED)	String
value	The actual value that caused the error (Only for FAILED)	String
path	The field in the request body where the error occurred (Only for FAILED)	String
location	Location in the request where the issue was found (e.g., body) (Only for FAILED)	String

Sample Response Body

---

SUCCESS:

{ "statusCode": 0, "status": "SUCCESS", "statusDesc": "Passport Verified Successfully", "data": { "result": { "fileNumber": "NG1064964059420", "givenName": "ASHISH PURUSHOTTAM", "surname": "MOHURLE", "typeOfApplication": "NORMAL", "applicationReceivedOnDate": "22/10/2020", "name": "ASHISH PURUSHOTTAM MOHURLE", "dob": "02/07/1995" } } }

 

FAILED:

Error from Passport Verification API:

{ "statusCode": 1, "status": "FAILED", "statusDesc": "Error from Passport Verification API Response !!!!", "data": { "error": { "name": "error", "message": "File No not Found", "status": 404, "reason": "NOT_FOUND", "type": "Not found", "statusCode": 404 } } }

FileNumber not Provided:

{ "statusCode": -1, "status": "INVALID REQUEST", "statusDesc": "FileNumber is required!!!", "data": [ { "type": "field", "value": "", "msg": "FileNumber is required!!!", "path": "fileNumber", "location": "body" } ] }

DOB not provided:

{ "statusCode": -1, "status": "INVALID REQUEST", "statusDesc": "DOB is required!!!", "data": [ { "type": "field", "value": "", "msg": "DOB is required!!!", "path": "dob", "location": "body" } ] }

Invalid DOB provided:

{ "statusCode": -1, "status": "INVALID REQUEST", "statusDesc": "DOB cannot be a future date.", "data": [ { "type": "field", "value": "02/07/2026", "msg": "DOB cannot be a future date.", "path": "dob", "location": "body" } ] }

Encrypted Sample Response Body

---

{ "ResponseData": "4t0EbC4ooNghQLHeHI8Y1tWXhl/GZjqOZdq+xIxWRwEkVMN7428DW6JC/ x1tGB2Wfy+uBpGEFc1mEwMg0n9fCb4BYFWEPCN6Hpq09PAOF3k/VvRoMymDCOpsspZL6hj5ReA/ KhtHq/ KYfD03f4ASRsjw4mrk6fKGzIzy54kZDk3kPZ881r2uJ0eSFrc0X0AFDviJwY0Tctd3stmVSSwcmqiXGBBQ /kTFTlDn/QdgyrX0g+3aZGZKZIb0Mnneedo0R8t2lyAatS7lCZh/nCgsy8n70ObwKdPfywHV/ VTDpkp+lqfwFD30aEmEveEgbw1DRRT+f+/pbd/ Yb017nTx4IwnjNj+FcxECZ9Qq91nsw+TggdpDNJ1PHN21cadOEiYmPEaRTVtTsOjlII9Nty0rxUctdNzQQ6 FRx/VQWPaWlebGc6yZ5OOc064SAqRNMdR8" }

Status Codes

Code	Significance	Description
0	SUCCESS	Passport Verified Successfully
1	FAILED	Error from Passport Verification API Response !!!!
-1	INVALID REQUEST	FileNumber is required!!! DOB is required!!! DOB cannot be a future date.