curl "https://sandbox.core.linkio.world/api/payments/list?type=onramp&status=success&limit=10&decode=true" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "Payments retrieved",
"count": 1,
"pagination": { "page": 1, "limit": 10, "total": 1, "total_pages": 1, "has_more": false },
"payments": [
{
"id": "pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE",
"customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
"reference_id": "ref_7tY1wZ4cB6dE8fK2mQ9xLp3VnR",
"quote_id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"quote": {
"id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"source_amount": "150000",
"source_currency": "NGN",
"target_amount": "97.71",
"target_currency": "USDC",
"network": "solana",
"rate": "1535",
"payment_method": "bank_transfer",
"payout_method": "stablecoin"
},
"customer": { "id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE", "name": "Ada Obi", "email": "ada@example.com" },
"type": "onramp",
"status": "success",
"state": "completed",
"transaction_hash": "8c1f0e9a…",
"created_at": "2026-10-28T10:15:02.000Z",
"updated_at": "2026-10-28T10:21:17.000Z"
}
]
}
Payments
List payments
Get your payments, one page at a time, with filters.
GET
/
payments
/
list
curl "https://sandbox.core.linkio.world/api/payments/list?type=onramp&status=success&limit=10&decode=true" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "Payments retrieved",
"count": 1,
"pagination": { "page": 1, "limit": 10, "total": 1, "total_pages": 1, "has_more": false },
"payments": [
{
"id": "pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE",
"customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
"reference_id": "ref_7tY1wZ4cB6dE8fK2mQ9xLp3VnR",
"quote_id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"quote": {
"id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"source_amount": "150000",
"source_currency": "NGN",
"target_amount": "97.71",
"target_currency": "USDC",
"network": "solana",
"rate": "1535",
"payment_method": "bank_transfer",
"payout_method": "stablecoin"
},
"customer": { "id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE", "name": "Ada Obi", "email": "ada@example.com" },
"type": "onramp",
"status": "success",
"state": "completed",
"transaction_hash": "8c1f0e9a…",
"created_at": "2026-10-28T10:15:02.000Z",
"updated_at": "2026-10-28T10:21:17.000Z"
}
]
}
Requires the Ramps, banks & methods scope (payments read).
Headers
string
default:"2026-10-29-atlas"
required
Your account’s API version.
Query
integer
default:"1"
Which page. Starts at 1.
integer
default:"25"
How many per page. Up to 100.
string
default:"desc"
desc (newest first) or asc.string
default:"created_at"
created_at or updated_at.string
onramp or offramp.string
pending, success, or failed.string
Any state, for example
fiat_pending or completed.string
Only this customer’s payments.
string
Created at or after this date, for example
2026-10-01.string
Created before this date. Must be later than
created_after.string
default:"false"
true to include the quote and customer details in each payment.Response
200 OK
string
successstring
Payments retrievedinteger
How many payments are on this page.
object
page, limit, total, total_pages, has_more.array
The payments. Each has the same fields as Get a payment.
Errors
| Status | Code | Why |
|---|---|---|
422 | validation_failed | A filter is invalid. For example limit must be at most 100, or created_before must be later than created_after. |
curl "https://sandbox.core.linkio.world/api/payments/list?type=onramp&status=success&limit=10&decode=true" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "Payments retrieved",
"count": 1,
"pagination": { "page": 1, "limit": 10, "total": 1, "total_pages": 1, "has_more": false },
"payments": [
{
"id": "pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE",
"customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
"reference_id": "ref_7tY1wZ4cB6dE8fK2mQ9xLp3VnR",
"quote_id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"quote": {
"id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"source_amount": "150000",
"source_currency": "NGN",
"target_amount": "97.71",
"target_currency": "USDC",
"network": "solana",
"rate": "1535",
"payment_method": "bank_transfer",
"payout_method": "stablecoin"
},
"customer": { "id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE", "name": "Ada Obi", "email": "ada@example.com" },
"type": "onramp",
"status": "success",
"state": "completed",
"transaction_hash": "8c1f0e9a…",
"created_at": "2026-10-28T10:15:02.000Z",
"updated_at": "2026-10-28T10:21:17.000Z"
}
]
}
Last modified on October 29, 2026
Was this page helpful?