Retrieves an array with a customer object that matches the provided reference_id - the identifier provided by you
The Customer Object is a standard data structure to hold information relating to one of your customers. It has the following major components:
- A Type of customer (Individual or Business)
- Basic descriptive details of that customer
- Addresses of the customer
- Identity accounts and KYC documents to prove the legitimacy of the customer
- Other metadata
API version in date semantic. Attach this parameter when calling a specific API version. List of API versions can be found here.
The sub-account user-id that you want to make this transaction for.
This header is only used if you have access to xenPlatform. See xenPlatform for more information
Your identifier for the customer
Successful operation
{
"data": [
{
"id": "cust-239c16f4-866d-43e8-9341-7badafbc019f",
"reference_id": "demo_1475801962607",
"type": "INDIVIDUAL",
"individual_detail": {
"given_names": "John",
"surname": "Doe",
"nationality": null,
"place_of_birth": null,
"date_of_birth": null,
"gender": null,
"employment": null
},
"business_detail": null,
"email": "customer@website.com",
"mobile_number": null,
"phone_number": null,
"hashed_phone_number": null,
"addresses": [],
"identity_accounts": [],
"kyc_documents": [],
"description": null,
"metadata": {},
"created": "2020-03-30T06:12:47.212Z",
"updated": "2020-03-30T06:12:47.212Z"
}
],
"has_more": false
}List of customer object
Customer Object
Xendit unique Capture ID generated as reference for the end user
A Reference ID from merchants to identify their request.
Mobile number of customer in E.164 format +(country code)(subscriber number)
Additional contact number of customer in E.164 format. May be a landline
FormatE.164 international standard +(country code)(subscriber number)
Hashed phone number
E-mail address of customer
ISO 3166-1 alpha-2 Country Code
Line 1 of street address e.g., building name and apartment number
Line 2 of street address e.g., building name and apartment number
City, village or town of residence of customer
Province, state or region of residence of customer
ZIP/Postal Code of customer
Address type
Defaults to false. Indicates that the information provided refers to the customer’s primary address
ISO 3166-1 alpha-2 Country Code
Generic ID type
Specific ID type for IDENTITY_CARD types
Free text description of the type of document (e.g., NIB, SIUP, AKTA). Characters alphanumeric. No special characters is allowed.
Unique alphanumeric identity document number or code. Characters alphanumeric. No special characters is allowed.
Expiry date, if relevant
Free text to capture the full name(s) of the individual or business as defined on the document, if relevant. Characters alphanumeric. No special characters is allowed.
Array of file ids returned from uploads to the files endpoint, representing images of the front/back of the document, in png/jpg/jpeg/pdf format
Merchant-provided description for the customer. Characters alphanumeric. No special characters is allowed.
Date of which the account that the shopper had to create/sign up on the merchant's website
Country within which the account that the shopper had to create/sign up on the merchant’s website resides (e.g. accounts created on Shopee SG have SG as the value for this field. ISO 3166-2 Country Code
Object of additional information related to the customer. Define the JSON properties and values as required to pass information through the APIs. You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long. This is only for your use and will not be used by Xendit.
The provided id does not exist. Please review the id and try again