Skip to content

Get a customer

API v2 is in public beta: endpoints and fields can change before general availability. See the changelog

GET/back_in_stock/customers/{id}

Costs 1 rate-limit point · Rate limits

Read one customer, as the header of their page under the Customers tab shows it.

Their signups are GET /back_in_stock/signups?customer_id=.

Also searched asshow customercustomer detailsis this customer subscribed

Path parameters

Returns

The customer object.

Errors

404
not_found

The path is valid but nothing with that id exists in this store.

422
validation_failed

The request failed validation.

Any request can also fail with auth_invalid (401) or rate_limited (429).

Every error has the same shape: see Errors and the list of error codes.

GET/back_in_stock/customers/{id}
curl "https://app.stoqapp.com/api/v2/external/back_in_stock/customers/string" \
  -H "X-Auth-Token: $STOQ_API_KEY"
Response
{
  "id": "string",
  "name": "string",
  "email": "string",
  "phone": null,
  "accepts_marketing": true,
  "unsubscribed_at": null,
  "created_at": "2026-01-15T09:30:00Z"
}