Retrieve a Payment by ID — GET /payments/{id}

Fetches a single payment by its ID, returning the full payment object including current status, deposit address, fiat breakdown, and confirmation count. Requires the payments:read scope.

Request

GET https://api.blockra.io/payments/{id}

Path parameters

string

required

The payment ID, prefixed pay_ (e.g. pay_a1b2c3d4e5f6g7h8i9j0k1l2).

Response

Returns a 200 with the matching payment object wrapped in the standard data envelope.

status

string

Current lifecycle status: pending, detected, completed, overpaid, underpaid, expired, failed, or cancelled.

customers

object

The associated customer { id, email }, or null if no customer was linked.

detected_at

string

ISO-8601 timestamp when funds were first seen on-chain, or null.

completed_at

string

ISO-8601 timestamp when the payment was confirmed, or null.

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

const res = await fetch(
  "https://api.blockra.io/payments/pay_a1b2c3d4e5f6g7h8i9j0k1l2",
  { headers: { "X-API-Key": process.env.BLOCKRA_API_KEY! } }
);
const { data } = await res.json();

{
  "data": {
    "id": "pay_a1b2c3d4e5f6g7h8i9j0k1l2",
    "status": "completed",
    "asset": "LTC",
    "network": "litecoin",
    "fiat_currency": "USD",
    "fiat_amount": 9.99,
    "fee_fiat": 0.22,
    "net_fiat": 9.77,
    "confirmations": 4,
    "reference": "order_1234",
    "customers": {
      "id": "cus_9z8y7x6w5v4u3t2s1r0q",
      "email": "buyer@example.com"
    },
    "detected_at": "2026-07-08T12:41:00.000Z",
    "completed_at": "2026-07-08T12:52:00.000Z",
    "created_at": "2026-07-08T12:39:00.000Z"
  },
  "error": null
}

List PaymentsRetrieve a paginated, filterable list of your Blockra payments. Filter by status, asset, date range, and amount. Requires the payments:read scope.

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

const res = await fetch(
  "https://api.blockra.io/payments/pay_a1b2c3d4e5f6g7h8i9j0k1l2",
  { headers: { "X-API-Key": process.env.BLOCKRA_API_KEY! } }
);
const { data } = await res.json();

{
  "data": {
    "id": "pay_a1b2c3d4e5f6g7h8i9j0k1l2",
    "status": "completed",
    "asset": "LTC",
    "network": "litecoin",
    "fiat_currency": "USD",
    "fiat_amount": 9.99,
    "fee_fiat": 0.22,
    "net_fiat": 9.77,
    "confirmations": 4,
    "reference": "order_1234",
    "customers": {
      "id": "cus_9z8y7x6w5v4u3t2s1r0q",
      "email": "buyer@example.com"
    },
    "detected_at": "2026-07-08T12:41:00.000Z",
    "completed_at": "2026-07-08T12:52:00.000Z",
    "created_at": "2026-07-08T12:39:00.000Z"
  },
  "error": null
}

​Request

​Path parameters

​Response

Request

Path parameters

Response