Get Status

Use this API to get the status of the created PAN Verification via OCR request. You need to enter either the reference ID or verification ID to get the status. When you provide both the values, the API prioritises the reference ID.

Response Codes

Sub Code	Status	Message	Next Action
200	SUCCESS	PAN card is valid	-
200	SUCCESS	PAN card is invalid	-
200	SUCCESS	Insufficient balance	Ensure you have sufficient balance and then verify PAN via OCR.
200	SUCCESS	verification attempt failed	Use the API to verify again.
400	ERROR	x-client-id is missing in the request.	Enter all the header information in the API request.
400	ERROR	x-client-secret is missing in the request.	Enter all the header information in the API request.
400	ERROR	provide verification_id or reference_id	Enter a valid verification_id or reference_id in the request.
400	ERROR	Bad request, please check API documentation	Enter a valid reference_id in the request.
401	ERROR	Invalid clientId and clientSecret combination	Ensure you enter valid x-client-id and x-client-secret information in the API request.
403	ERROR	IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://www.cashfree.com/docs/secure-id/get-started/integration/ip-whitelisting-verification	Whitelist the IP address.
404	ERROR	reference_id does not exist.	Enter a valid reference_id.
404	ERROR	verification_id does not exist.	Enter a valid verification_id
500	ERROR	something went wrong	Try again after some time.

Assistant

Responses are generated using AI and may contain mistakes.

Authorizations

x-client-id · string · header · required

Client ID. You can find your ID in the Merchant Dashboard.

x-client-secret · string · header · required

Client secret key. You can find your secret key in the Merchant Dashboard.

Headers

x-cf-signature · string

Send the signature if IP is not whitelisted

Query Parameters

reference_id · string · default: 1358

It is the unique ID created by Cashfree Payments that you receive in the response of PAN Verification via OCR API.

verification_id · string · default: ABC00123

It is the unique ID you created to identify the verification request.

Response

200

application/json

Success response for getting the PAN OCR information

PAN Verification via OCR success response