Get a customer

GET

/v1/customers/:id

curl "https://api.summerbase.com/v1/customers/:id" \
  -H "Authorization: Bearer sb_..."

Fetch one customer, by Summerbase id or by any source’s id for them.

Parameters

Path Parameters

id

required

string

The customer’s Summerbase id, or an identity ref: a source slug and that source’s own id for them, joined by a colon — stripe:cus_123.

Example

0199a7c2-4e1b-7f38-b9d2-5a6c8e0f1d73

Query Parameters

expand[]

Array<string>

<= 10 items

Allowed values: country erasures subscriptions

Relationships to include in the response instead of fetching separately. A dotted path expands what an expanded record can expand in turn — at most 4 deep, 10 paths a request, and never back to a record already on the path.

Response

Returns the customer object.

Media typeapplication/json

Example

{
  "arr": "15000.00",
  "churned_at": null,
  "country_code": "US",
  "created_at": "2025-11-03T16:20:04Z",
  "email": "billing@northwind.example.com",
  "first_paying_at": "2025-12-01T10:04:00Z",
  "first_seen_at": "2025-11-03T16:20:00Z",
  "first_subscribed_at": "2025-11-17T10:04:00Z",
  "id": "0199a7c2-4e1b-7f38-b9d2-5a6c8e0f1d73",
  "identities": [
    "stripe:cus_QX7bN2kLp4Rt9v",
    "backend:acct_4821"
  ],
  "mrr": "1250.00",
  "name": "Northwind Labs",
  "object": "customer",
  "properties": {
    "seats": 25
  },
  "properties_by_source": {
    "backend": {
      "seats": 25
    },
    "stripe": {
      "email": "billing@northwind.example.com",
      "name": "Northwind Labs"
    }
  },
  "signed_up_at": "2025-11-03T16:20:00Z",
  "status": "paying"
}