Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Business Verification Validate API

post/kyc/public_registry/validate#business-verification

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
OR
OR
OR
OR

Example response

{
  "kycStatus": "SUCCESS",
  "status": "SUCCESS",
  "message": "KYC Details for PAN retrieved successfully",
  "kycResult": {
    "idNumber": "ABCDE12345",
    "idStatus": "VALID",
    "name": "AMAZON SELLER SERVICES PRIVATE LIMITED"
  },
  "responseKey": "success_pan",
  "responseCode": "S00000",
  "requestTimestamp": "2020-07-24 21:25:20.778016 IST (GMT +0530)",
  "responseTimestamp": "2020-07-24 21:25:21.991470 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}