List payment intents
title: "List payment intents" description: "GET /v1/payment-intents — paginate through your intents, filtered by status, network, or date." section: "API reference" order: 13 updated: "2026-04-18" sourcePath: "content/docs/api/payment-intents/list.mdx"
GET/v1/payment-intents
Returns a paginated list of payment intents, newest first. Use cursor pagination via the starting_after query parameter.
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| limit | integer | optional | Page size, 1–100. Default 25. |
| starting_after | string | optional | Cursor — an intent ID. Returns results created after it. |
| status | string | optional | Filter by requires_payment, processing, completed, expired, or canceled. |
| network | string | optional | Filter by network: ethereum, polygon, solana, tron, bnb. |
| created_gte | string | optional | ISO-8601 lower bound on created_at. |
| created_lt | string | optional | ISO-8601 strict upper bound on created_at. |
Example
curl "https://api.bchainpay.com/v1/payment-intents?limit=2&status=completed" \
-H "Authorization: Bearer $BCHAINPAY_API_KEY"Response — 200 OK
{
"object": "list",
"has_more": true,
"next_cursor": "pi_3L9k42",
"data": [
{
"id": "pi_3L9k...42",
"status": "completed",
"amount_cents": 4999,
"settlement_currency": "USDC",
"network": "polygon",
"reference": "INV-2026-001",
"completed_at": "2026-04-18T12:08:11Z"
},
{
"id": "pi_3L9k...41",
"status": "completed",
"amount_cents": 19900,
"settlement_currency": "USDT",
"network": "tron",
"reference": "INV-2026-000",
"completed_at": "2026-04-18T11:51:02Z"
}
]
}To page forward, pass next_cursor as starting_after on the next request.