This endpoint returns a customer record. Most commonly used to fetch a customer’s point balance and unique referral link.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Please note:When using the “with_history” flag set totrue, the completed_at value returned with the customer's history items represents the created_at date passed with the Custom Action API call. This registers when the customer actually completed the action, and not when it was registered in the Yotpo system.
Please note:If you're a Shopify merchants who uses, Klaviyo, or a custom ESP integration and joined Yotpo Loyalty & Referrals after August 2024, you will get a response with the following details for the “with_referral_code” parameter:
"referal_link{
"link": "rwrd.io/abc123"
"code":"abc123"
"expired":false },
points_expire_at
points_expire_atThe response includes points_expire_at: the date when the customer's points are set to expire, or null when points never expire under your policy. The value follows your Points expiration policy (Last Activity, Date Earned, or Never expire). For Date Earned, the field is the next upcoming expiration across batches (not every batch date). The same field and rules apply to GET /v1/customers, GET /v2/customers, and list responses from GET /api/v2/customers/recent. For the full description, see any webhook that returns a customer object with this field—for example Points Earned.