Skip to main content
GET
/
v1
/
sdk
/
customers
/
{reference}
Get customer by reference
curl --request GET \
  --url https://api.example.com/v1/sdk/customers/{reference}
{
  "email": "customer@example.com",
  "externalRef": "auth_user_12345",
  "name": "John Doe",
  "purchases": [
    {
      "amount": 9900,
      "currency": "USD",
      "endDate": "2025-11-27T10:00:00Z",
      "planName": "Pro Plan",
      "productReference": "prd_abc123",
      "reference": "sub_abc123",
      "startDate": "2025-10-27T10:00:00Z",
      "status": "active"
    }
  ],
  "reference": "cus_3c4d5e6f7g8h"
}

Path Parameters

​
reference
string
required

Customer reference identifier

Example:

"cus_3c4d5e6f7g8h"

Response

Customer retrieved successfully

​
email
string
required

Customer email address

Example:

"customer@example.com"

​
name
string
required

Customer full name

Example:

"John Doe"

​
reference
string
required

Customer reference identifier

Example:

"cus_3c4d5e6f7g8h"

​
externalRef
string

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

Example:

"auth_user_12345"

​
purchases
object[]

Active purchases