Retrieve a Customer — GET /customers/{id}

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

string

required

The customer ID (prefixed cus_).

Response

string

The customer ID.

string

The customer’s email.

name

string

Their name, or null.

order_count

integer

Number of settled payments.

total_spent

number

Lifetime net received from this customer (fiat).

created_at

string

ISO-8601 time the customer was first seen.

recent_payments

array

Their latest payments (up to 20), newest first. Each item has id, status, asset, net_fiat, fiat_currency, and created_at.

curl https://api.blockra.io/customers/cus_9z8y7x6w5v4u3t2s1r0q \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "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
}

Get BalanceRead your available and pending balance per coin, with live USD estimates and a 30-day series. Requires balance:read.

curl https://api.blockra.io/customers/cus_9z8y7x6w5v4u3t2s1r0q \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "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
}

​Request

​Path parameters

​Response

Request

Path parameters

Response