> ## 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 Payment by ID — GET /payments/{id}

> Fetch a single payment by its ID. Returns the full payment object including status, deposit details, fiat breakdown, and on-chain confirmation count.

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

<ParamField path="id" type="string" required>
  The payment ID, prefixed `pay_` (e.g. `pay_a1b2c3d4e5f6g7h8i9j0k1l2`).
</ParamField>

## Response

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

<ResponseField name="status" type="string">
  Current lifecycle status: `pending`, `detected`, `completed`, `overpaid`, `underpaid`, `expired`, `failed`, or `cancelled`.
</ResponseField>

<ResponseField name="customers" type="object">
  The associated customer `{ id, email }`, or `null` if no customer was linked.
</ResponseField>

<ResponseField name="detected_at" type="string">
  ISO-8601 timestamp when funds were first seen on-chain, or `null`.
</ResponseField>

<ResponseField name="completed_at" type="string">
  ISO-8601 timestamp when the payment was confirmed, or `null`.
</ResponseField>

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

  ```ts Node.js theme={null}
  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();
  ```
</RequestExample>

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