> ## Documentation Index
> Fetch the complete documentation index at: https://docs.accelebit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/customers/{id} — Retrieve a Customer

> Fetch a customer record by its Accelebit UUID. Returns the externalId, email, metadata, and creation timestamp scoped to your merchant account.

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

<ParamField path="id" type="string" required>
  The Accelebit UUID of the customer you want to retrieve. This is the `id` value returned when the customer was created.
</ParamField>

## Headers

<ParamField header="X-API-Key" type="string" required>
  Your secret API key. Keep this value server-side and never expose it in client code.
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="data properties">
    <ResponseField name="id" type="string">
      Accelebit-generated UUID for this customer.
    </ResponseField>

    <ResponseField name="externalId" type="string">
      The external identifier you provided when the customer was created.
    </ResponseField>

    <ResponseField name="email" type="string">
      The customer's email address, if one was provided.
    </ResponseField>

    <ResponseField name="metadata" type="object">
      The key-value metadata attached to the customer record.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp indicating when the customer record was first created.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.gateway.accelebit.com/v1/customers/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
    -H "X-API-Key: smtgw_sk_test_your_secret_key"
  ```

  ```typescript Node.js theme={null}
  const response = await fetch(
    'https://api.gateway.accelebit.com/v1/customers/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
    {
      headers: {
        'X-API-Key': process.env.ACCELEBIT_SECRET_KEY!,
      },
    }
  );

  const result = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.gateway.accelebit.com/v1/customers/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
      headers={'X-API-Key': ACCELEBIT_SECRET_KEY},
  )

  result = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "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"
    }
  }
  ```

  ```json 404 - Not Found theme={null}
  {
    "data": null,
    "error": {
      "status": 404,
      "name": "NOT_FOUND",
      "message": "Customer a1b2c3d4-e5f6-7890-abcd-ef1234567890 not found"
    }
  }
  ```
</ResponseExample>