Skip to main content
POST
/
v2
/
finance
/
customer-data-pull
Customer Financial Data Pull
curl --request POST \
  --url https://bgv.konnectnxt.com/api/v2/finance/customer-data-pull \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mobile_number": "9553226860",
  "full_name": "Manish Gupta",
  "consent_purpose": "Financial data verification for background verification"
}
'
{
  "status": "success",
  "code": 200,
  "message": "Financial data fetched successfully.",
  "data": {
    "reportOrderNumber": "2678022808",
    "personalInfo": {
      "fullName": "MANCHA VENKATA VENKATA SAI",
      "dob": "2001-12-02",
      "gender": "Male",
      "totalIncome": "",
      "occupation": "SALARIED",
      "age": "24"
    },
    "phoneInfo": [
      {
        "sequence": "1",
        "reportedDate": "2026-02-15",
        "typeCode": "H",
        "number": "9553226860"
      },
      {
        "sequence": "2",
        "reportedDate": "2026-05-15",
        "typeCode": "M",
        "number": "9553226860"
      }
    ],
    "emailInfo": [
      {
        "sequence": "1",
        "reportedDate": "2026-04-30",
        "emailAddress": "VENKATASAIM16@GMAIL.COM"
      }
    ],
    "identityInfo": {
      "panNumber": [
        {
          "idNumber": "NSCPS7889L",
          "sequence": "1"
        }
      ],
      "passportNumber": [],
      "drivingLicense": [],
      "voterId": [],
      "aadhaarNumber": [],
      "rationCard": [],
      "otherId": []
    },
    "addressInfo": [
      {
        "sequence": "1",
        "address": "SO VENKATESWARA RAO H NO 121277 VIRAT NA",
        "state": "ANDHRA PRADESH",
        "type": "Permanent",
        "postal": "523225",
        "reportedDate": "2026-04-30"
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 999
}
Fetches financial and bureau data for an individual using their mobile number and full name. The response returns personal information, phone records, email records, identity documents, and address history sourced from the credit bureau. Credit usage: 1 credit is consumed per request whenever the bureau is successfully reached — including when the bureau returns no data (404). No credit is consumed for 400, 401, 402, 403, or 500 responses.

Authorizations

​
Authorization
string
header
required

API key issued by KonnectNXT. Pass as Authorization: Bearer <your_api_key>.

Body

application/json
​
mobile_number
string
required

10-digit Indian mobile number starting with 6, 7, 8, or 9. All digits cannot be identical (e.g. 9999999999 is invalid).

Example:

"9553226860"

​
full_name
string
required

Full name of the individual. Only letters, spaces, and dots are allowed.

Example:

"Manish Gupta"

​
consent_purpose
string

Purpose for which consent is taken from the individual. If provided, must be more than 20 characters. Defaults to "Financial data verification for background verification" when not supplied.

Example:

"Financial data verification for background verification"

​
document_type
string

Optional document type for an additional identity lookup (e.g. PAN, AADHAAR).

Example:

""

​
id_value
string

Optional ID value associated with the supplied document_type.

Example:

""

Response

Customer financial data fetched successfully

​
status
enum<string>
required

Overall status of the API

Available options:
success,
error
​
code
integer
required

HTTP status code

Example:

400

​
message
string
required

Description of the response or error

Example:

"Invalid request parameters"

​
data
object
required
​
credits_used
integer
required

Represents the total number of credits used in this request.

Example:

3

​
credits_left
integer
required

Represents the remaining credits available for use.

Example:

4040