ID Converters

Overview

The ID Converters service enables you to derive or fetch related identifiers based on one primary input. These converters streamline workflows in KYC, compliance, logistics, and vehicle identity verification.

Features

Fast and accurate conversion using verified sources
Seamless integration via dashboard or APIs
Secure access with token-based authentication
Real-time or near real-time response times
Ideal for use in compliance, insurance, lending, and logistics sectors

Supported Documents

API	Description	Use Case Example
PAN to GSTIN	Retrieves the GSTIN associated with a PAN number.	Tax Compliance: Verify a vendor's GST registration to ensure tax compliance.
RC to Chassis Number	Retrieves the Chassis number linked to a vehicle's Registration Certificate (RC).	Insurance: Validate vehicle details before issuing a policy to ensure accurate coverage.
Chassis Number to RC	Retrieves the vehicle's Registration Certificate (RC) linked to a Chassis number.	Asset Recovery: Identify registered vehicle details using chassis numbers during repossession or fraud investigations

1. PAN to GSTIN

PAN Stands for Permanent Account Number and it is a ten-digit alphanumeric number issued by the Income Tax Department of India.

{
  "reference_id": "ABCD1234",
  "consent": true,
  "purpose": "To retreive GSTIN details",
  "pan": "<PAN NUMBER>"
}

{
  "decentro_txn_id": "ABCD12341234",
  "status": "SUCCESS",
  "response_key": "success_gstin_retrieval",
  "message": "GSTIN Data was successfully retrieved",
  "data": [
    {
      "gstin": "<GSTIN_NUMBER>",
      "status": "<STATUS>",
      "state": "<STATE>"
    }
  ]
}

Response Codes

Response Key	Message / Description	Status
`success_gstin_retrieval`	Successfully found GSTIN linked to PAN.	SUCCESS
`success_gst_search_by_pan`	No matching record found for the given input.	SUCCESS
`error_invalid_pan`	The provided PAN is invalid.	FAILURE
`error_consent_false`	Consent was not provided or set to false in the request.	FAILURE
`error_duplicate_reference_id`	The provided reference ID has already been used in a previous call.	FAILURE
`error_short_purpose_length`	Purpose should be at least 20 characters in length.	FAILURE
`error_empty_pan`	PAN cannot be null or empty	FAILURE

2. RC to Chassis Number

Use this API to fetch the Chassis Number associated with a valid Vehicle Registration Certificate (RC) Number.

{
  "reference_id": "52baedb8-6460-4226-94b7-9c6a0b923639",
  "consent": true,
  "purpose": "To retreive Chassis details",
  "id": "<RC number>"
}

{
    "decentroTxnId": "9A08696EF56440E8A3786D2DFB902995",
    "status": "SUCCESS",
    "responseCode": "S00000",
    "message": "Chassis number data was successfully retrieved.",
    "data": {
        "chassisNumber": "<CHASSIS NUMBER>"
    },
    "responseKey": "success_chassis_number_retrieval"
}

Response Codes

Response Key	Message / Description	Status
`success_chassis_number_retrieval`	Chassis number retrieved successfully from RC number.	SUCCESS
`error_no_record_found`	No matching record found for the given input.	SUCCESS
`error_invalid_rc_number`	The provided RC number is invalid.	FAILURE
`error_consent_false`	Consent was not provided or set to false in the request.	FAILURE
`error_duplicate_reference_id`	The provided reference ID has already been used in a previous call.	FAILURE
`error_short_purpose_length`	Purpose should be at least 20 characters in length.	FAILURE

3. Chassis Number to RC

Use this API to fetch the Chassis Number associated with a valid Vehicle Registration Certificate (RC) Number.

{
  "reference_id": "52baedb8-6460-4226-94b7-9c6a0b923639",
  "consent": true,
  "purpose": "To retreive Chassis details",
  "id": "<Chassis number>"
}

{
  "decentroTxnId": "2C5F44978CC245A185A0FE115353EB06",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "Vehicle RC number data was successfully retrieved.",
  "data": {
    "rcNumber": "<RC Number>"
  },
  "responseKey": "success_rc_number_retrieval"
}

Response Codes

Response Key	Message / Description	Status
`success_rc_number_retrieval`	RC retrieved successfully from Chassis number.	SUCCESS
`error_no_record_found`	No matching record found for the given input.	SUCCESS
`error_invalid_chassis_number`	The provided Chassis number is invalid.	FAILURE
`error_consent_false`	Consent was not provided or set to false in the request.	FAILURE
`error_duplicate_reference_id`	The provided reference ID has already been used in a previous call.	FAILURE
`error_short_purpose_length`	Purpose should be at least 20 characters in length.	FAILURE