v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Customer Data Pull API

This API is used to fetch customer data using their name and mobile or an ID document

post/v2/financial_services/data/pull

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 API request.

consentboolean required

true/false 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)

namestring required

The full name of the individual as per official docuemnts

mobilestring required

The mobile number of the individual

document_typestring

id_valuestring

Response

200

decentroTxnIdstring

statusstring

responseCodestring

messagestring

responseKeystring

Example response

{
  "decentroTxnId": "996FE595C3CC4F519DB0AE2949988985",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "Data pulled successfully",
  "data": {
    "reportOrderNumber": "2451629666",
    "personalInfo": {
      "fullName": "Manish Gupta ",
      "dob": "1990-12-13",
      "gender": "Male",
      "totalIncome": "1",
      "age": "35"
    },
    "phoneInfo": [
      {
        "sequence": "1",
        "reportedDate": "2026-02-07",
        "typeCode": "H",
        "number": "999999999"
      }
    ],
    "emailInfo": [
      {
        "sequence": "1",
        "reportedDate": "2025-06-30",
        "emailAddress": "joe@gmail.COM"
      }
    ],
    "identityInfo": {
      "panNumber": [
        {
          "idNumber": "AQEPT3190J",
          "sequence": "1"
        }
      ],
      "passportNumber": [
        {
          "idNumber": "M6386489",
          "sequence": "1"
        }
      ],
      "aadhaarNumber": [
        {
          "idNumber": "XXXXXXXXXXXX",
          "sequence": "1"
        }
      ]
    },
    "addressInfo": [
      {
        "sequence": "1",
        "address": "202 SR RUBY APARTMENTS  13 C MAIN INDIRANAGAR BENGALURU-560038",
        "state": "KARNATAKA",
        "type": "Primary",
        "postal": "560038",
        "reportedDate": "2026-02-07"
      }
    ]
  },
  "responseKey": "success_customer_data_pull"
}