Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Customer Verification Validate API

post/kyc/public_registry/validate

Headers

client_idstring required

ID/identifier that is provided by Decentro to a specific client and environment. Please note, this may change based on the environment you are on.

client_secretstring required

The confidential credential provided by Decentro that is associated with the client_id

Request body

reference_idstring required

Any unique ID assigned by you for this request

document_typestring required

The type of ID that you want to validate. Only special character allowed is underscore.

id_numberstring required

The national ID number that is present on the above document

consentstring required

Y/N based on the consent given by the customer. Mandatory as per regulation.

consent_purposestring required

The purpose of taking this consent from your customer. Mandatory as per regulation. (>20 characters)

Response

200

OR
OR
OR
OR
OR
OR
OR

Example response

{
  "kycStatus": "SUCCESS",
  "status": "SUCCESS",
  "message": "PAN details retrieved successfully.",
  "kycResult": {
    "idNumber": "AAAAA1111A",
    "idStatus": "VALID",
    "category": "INDIVIDUAL OR PERSON",
    "name": "JOHN DOE"
  },
  "responseKey": "success_pan",
  "responseCode": "S00000",
  "requestTimestamp": "2026-04-02 11:57:19.313169 IST (GMT +0530)",
  "responseTimestamp": "2026-04-02 11:57:21.861186 IST (GMT +0530)",
  "decentroTxnId": "1891C0A8030040239008B95622B43A62"
}