Skip to main content

Customer Info​

The Customer Info API which allows distributors to pass only a customer identifier and receive complete customer information. The returned data is used to auto-populate the landing page and proposal journey.

Request Body required

1SB customer Info request

    customerHashId string required

    Unique customer identifier. Mandatory field used to fetch complete customer information and pre-populate the customer journey.

    loan_type string

    Possible values: <= 5 characters, [HL, TW, CL]

    Loan type associated with the customer. Optional field used for journey and product mapping. Example values include HL (Home Loan), PL (Personal Loan), GL (Gold Loan).

    customerPAN string

    Possible values: <= 10 characters

    Permanent Account Number (PAN) of the customer. Optional field; can be passed if available.

    firstName string

    Possible values: <= 50 characters

    First name of the customer. Optional identifier for customer lookup.

    lastName string

    Possible values: <= 50 characters

    Last name of the customer. Optional identifier for customer lookup.

    dateOfBirth date

    Date of birth of the customer in YYYY-MM-DD format. Optional field.

Responses

Successful Response

Schema
    reqId string

    Unique request identifier for tracking the API call

    errors object[]

    List of errors occurred during request processing

    data object

    Wrapper object holding customer data

    customer_info_id integer

    unique identifier for customer information

    customer_id string

    External or business customer identifier

    customer_info object

    Complete customer profile information

    personalInformation object

    Personal details of the customer

    title string

    Salutation of the customer

    firstName string

    First name of the customer

    middleName string

    Middle name of the customer

    lastName string

    Last name of the customer

    gender string

    Gender of the customer

    dateOfBirth date

    Date of birth of the customer

    maritalStatus string

    Marital status of the customer

    email string

    Email address of the customer

    mobileNumber string

    Primary mobile number of the customer

    otherMobileNumber string

    Alternate mobile number of the customer

    emergencyMobileNumber string

    Emergency contact mobile number

    telephoneNumber string

    Landline or telephone number

    nationality string

    Nationality of the customer

    professionalDetails object

    Professional and employment-related details of the customer

    qualification string

    Highest educational qualification

    occupation string

    Occupation type of the customer

    designation string

    Job designation of the customer

    organisation string

    Name of the employing organization

    annualIncome string

    Annual income of the customer

    kycDetails object

    Know Your Customer (KYC) related details

    panNumber string

    PAN number of the customer

    ckycNumber string

    Central KYC number

    eiaNumber string

    Electronic Insurance Account number

    aadharNumber string

    Aadhaar number of the customer

    communicationAddress object

    Communication address of the customer

    addressLine1 string

    Address line 1

    addressLine2 string

    Address line 2

    addressLine3 string

    Address line 3

    landmark string

    Nearest landmark

    zipCode string

    Postal or ZIP code

    city string

    City name

    state string

    State name

    country string

    Country name

    permanentAddress object

    Permanent residential address of the customer

    addressLine1 string

    Address line 1

    addressLine2 string

    Address line 2

    addressLine3 string

    Address line 3

    landmark string

    Nearest landmark

    zipCode string

    Postal or ZIP code

    city string

    City name

    state string

    State name

    country string

    Country name

    healthQuestionnaire object

    Health-related declarations of the customer

    tobacco string

    Possible values: [NO, YES]

    Indicates whether the customer consumes tobacco

    nomineeDetails object

    Nominee details provided by the customer

    firstName string

    Nominee first name

    middleName string

    Nominee middle name

    lastName string

    Nominee last name

    dateOfBirth date

    Nominee date of birth

    gender string

    Nominee gender

    relationship string

    Relationship of nominee with customer

    productDetails object

    Insurance product-related details

    cover string

    Policy cover amount

    sumInsured string

    Sum insured amount

    monthlyAmount string

    Monthly premium amount

    dependantDetails object

    Details of dependent family member

    firstName string

    Dependent first name

    middleName string

    Dependent middle name

    lastName string

    Dependent last name

    dateOfBirth date

    Dependent date of birth

    gender string

    Dependent gender

    relationship string

    Relationship of dependent with customer

    bankDetails object

    Bank account details for payment and refunds

    accountHolderName string

    Name of the bank account holder

    IFSCcode string

    IFSC code of the bank branch

    accountType string

    Type of bank account

    accountNumber string

    Bank account number

Loading...