Skip to main content
Use this endpoint to fetch a customer record by its Accelebit-generated UUID. Customers are scoped to your merchant account, so you can only retrieve records created under your own API key. To look up a customer by your own identifier instead, use the externalId you supplied when creating the record.

​
Path parameters

​
id
string
required
The Accelebit UUID of the customer you want to retrieve. This is the id value returned when the customer was created.

​
Headers

​
X-API-Key
string
required
Your secret API key. Keep this value server-side and never expose it in client code.

​
Response

​
data
object
curl https://api.gateway.accelebit.com/v1/customers/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: smtgw_sk_test_your_secret_key"

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "externalId": "user_12345",
    "email": "jane@example.com",
    "metadata": {
      "plan": "premium"
    },
    "createdAt": "2026-04-09T12:00:00.000Z"
  },
  "meta": {
    "timestamp": "2026-04-09T12:05:00.000Z"
  }
}