get https://{host}/v2/customers/
Retrieves the details of a customer from a specific source. Use embed to other parameters to fetch specific details required.
Retrieves details of a specific customer such as:
- profile information – first name, last name, registered date, registered at TILL
- recent profile updated – details of the recent update in profile information
- registered identifiers, communication channels
- loyalty information – loyalty status, registered date, purchases, etc.
- Multiple Loyalty Program Details: Program wise details if the org has multiple loyalty programs support
- Customer image
To fetch customer details from a specific account of a source (source with multiple accounts), you need to provide the respective account id.
If you attempt to retrieve data of any deleted customer after a successful PII deletion, you will receive the following response:
"message": "Customer is deleted after PII delete request"
API endpoint
{host}/v2//customers/{customerId}/{queryparameters}
Query parameters
| Parameter (Parameters marked with * are mandatory) | Type | Description |
|---|---|---|
| source* | Enum [INSTORE, MARTJACK, WECHAT, LINE, ALL] | Specifies the source of the customer details to be retrieved. |
| accountId | String | Unique identifier for the account. |
| embed | Array of String | Details to include in the response. Supported values: points, subscriptions, mlp, userGroup, gapDetails, promotionalPoints, expirySchedules, expiredPoints, customerImage, returnedPoints, associatedImages, segments.Note: The associated images parameter retrieves the barcode image details associated with the customer. |
| includedAllUserGroup2 | Boolean (false) | Pass true to see the customer details in all user groups. |
| userGroup2Id | Long | Unique ID of the user group to fetch customer details from. |
| includedUserGroup2LoyaltyDetails | Boolean (false) | Pass true to include loyalty details of user groups. |
| includedFraudDetails | Boolean (false) | Pass true to include fraud details of the customer in the response. |
| includedOnlyCurrentProfile | Boolean (false) | Pass true to fetch details of the current source and hide information from other sources. |
| ug2JoinedStartDate | DateTime | Start date for filtering customers who joined user groups. |
| ug2JoinedEndDate | DateTime | End date for filtering customers who joined user groups. |
| ug2Offset | Integer | Specifies the offset for pagination of user group results. |
| ug2Limit | Integer | Sets the maximum number of results to retrieve per page for user groups. |
| ug2SortBy | String (JoinedDate) | Specifies the field by which the user group results should be sorted. |
| ug2SortOrder | Enum [ASC, DESC] (DESC) | Specifies the sorting order for the user group results. |
| ug2PaginationDetails | Boolean | Pass true to include pagination details for user groups. |
Response parameters
| Parameter | Description |
|---|---|
| id | Unique identifier for the customer. |
| profiles | List of customer profiles containing various details such as name, attribution, identifiers, communication channels, source, etc. |
| loyaltyInfo | Information related to the customer's loyalty, including loyalty type, attribution, and lifetime purchases. |
| segments | Object containing the segment and partition names. Example: "Activity segment": "Lapsed". Here, the Segment name is Activity segment, Partition value is Lapsed. Meaning: The customer is classified as "Lapsed" in the "Activity segment" category, indicating that they have not been active for a certain period. |
| associatedWith | Code identifying the association of the customer (e.g., till code). |
| ug2Pagination | Pagination details for user group results related to the customer. |
| extendedFields | Additional extended fields associated with the customer, such as city and gender. |
| cardDetails | Details of the card owned by the customer, including card ID, issued date, expiry date, series information, status, and more. |
| warnings | List of warnings related to the response. |