Demography

METHOD: POST

RESOURCE URL

{{base-url}}/api/v1/request/customer-insights/kyc-attributes

You can either make this request by specifying the individual's BVN or mobile phone number.

Request body description

Field	Field Name	Data Type	Max Length	Required	Description
1	identificationType	String	10	True	Either 'bvn' or 'phone'
2	identificationNumber	String	13	True	Phone or BVN number

Response message description

Field	Field name	Data type	Description
1	responseCode	String	Response code of the request
2	responseMessage	String	Response mesaage of the request
3	data	Object	Response data containing kyc details of the request

Sample Request 1

{
	"identificationType": "bvn",
    "identificationNumber": "22260996349"
}

Sample Request 2

{
	"identificationType": "phone",
    "identificationNumber": "2348161106464"
}

Sample Response

{
    "responseCode": "00",
    "responseMessage": "Successful",
    "data": {
        "fullName": "KINGSLEY   UGWUEZUMBA",
        "state": "Imo",
        "dateOfBirth": "1991-08-05",
        "bvn": "22260996349",
        "phone": "2348161106464",
        "gender": "M",
        "ageCluster": "Millennial",
        "region": "south-east"
    }
}