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

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

> Fetch a single customer by ID, including lifetime totals and their most recent payments. Requires customers:read.

Returns a single customer with their lifetime totals and their 20 most recent payments. Requires the `customers:read` scope.

## Request

**`GET https://api.blockra.io/customers/{id}`**

### Path parameters

<ParamField path="id" type="string" required>
  The customer ID (prefixed `cus_`).
</ParamField>

## Response

<ResponseField name="id" type="string">
  The customer ID.
</ResponseField>

<ResponseField name="email" type="string">
  The customer's email.
</ResponseField>

<ResponseField name="name" type="string">
  Their name, or `null`.
</ResponseField>

<ResponseField name="order_count" type="integer">
  Number of settled payments.
</ResponseField>

<ResponseField name="total_spent" type="number">
  Lifetime net received from this customer (fiat).
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO-8601 time the customer was first seen.
</ResponseField>

<ResponseField name="recent_payments" type="array">
  Their latest payments (up to 20), newest first. Each item has `id`, `status`, `asset`, `net_fiat`, `fiat_currency`, and `created_at`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.blockra.io/customers/cus_9z8y7x6w5v4u3t2s1r0q \
    -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "cus_9z8y7x6w5v4u3t2s1r0q",
      "email": "buyer@example.com",
      "name": null,
      "order_count": 4,
      "total_spent": 312.40,
      "created_at": "2026-06-02T09:14:00.000Z",
      "recent_payments": [
        {
          "id": "pay_a1b2c3d4e5f6g7h8i9j0k1l2",
          "status": "completed",
          "asset": "LTC",
          "net_fiat": 9.77,
          "fiat_currency": "USD",
          "created_at": "2026-07-08T12:39:00.000Z"
        }
      ]
    },
    "error": null
  }
  ```
</ResponseExample>