Sign in
Customers

Get customer by reference

Retrieves a customer's details using their unique reference ID. Returns the customer's name, email, and active purchases. Only customers owned by the authenticated provider can be accessed.

get/v1/sdk/customers/{reference}

Path parameters

referencestring required
Example:cus_3c4d5e6f7g8h

Customer reference identifier

Response

Customer retrieved successfully

emailstring required

Customer email address

externalRefstring

External reference ID from your auth system (if set during creation or update)

namestring required

Customer full name

referencestring required

Customer reference identifier

Example response

{
  "email": "customer@example.com",
  "externalRef": "auth_user_12345",
  "name": "John Doe",
  "purchases": [
    {
      "amount": 9900,
      "cancellationReason": "Customer request",
      "cancelledAt": "2025-10-28T10:00:00Z",
      "currency": "GBP",
      "endDate": "2025-11-27T10:00:00Z",
      "exchangeRate": 1.32,
      "originalAmount": 7500,
      "planRef": "pln_abc123",
      "productName": "API Gateway Manager",
      "productRef": "prd_abc123",
      "reference": "pur_1A2B3C4D",
      "startDate": "2025-10-27T10:00:00Z",
      "status": "active"
    }
  ],
  "reference": "cus_3c4d5e6f7g8h"
}

Changes

Changed in 7 of the 27 revisions of this API.317

  • 60c2cd1caf831See the full diff
    • ▲

      the response's body type/format changed from object/ to / for status 404

      response-body-type-changed

    This revision also has 192 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • c6f97c4a54921See the full diff
    • ▲

      the response's body type/format changed from / to object/ for status 404

      response-body-type-changed

  • 052cc028fdfa1See the full diff
    • ○

      added the optional property purchases/items/planRef to the response with the 200 status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • d69c95d790d211See the full diff
    • ●

      removed the optional property purchases/items/productReference from the response with the 200 status

      response-optional-property-removed

    • ○

      added the optional property purchases/items/productRef to the response with the 200 status

      response-optional-property-added

  • 88abf6f50f112See the full diff
    • ○

      added the optional property purchases/items/exchangeRate to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property purchases/items/originalAmount to the response with the 200 status

      response-optional-property-added

    This revision also has 44 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 0e1cded2ee5d12See the full diff
    • ▲

      removed the required property purchases/items/planName from the response with the 200 status

      response-required-property-removed

    • ○

      added the optional property purchases/items/planSnapshot to the response with the 200 status

      response-optional-property-added

    • ○

      added the required property purchases/items/productName to the response with the 200 status

      response-required-property-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 9079f361f51c1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog