cURL
curl --request GET \ --url https://api.swiftpay.finance/v1/invoices/{id}/transactions \ --header 'X-Swift-Key: <api-key>'
{ "success": true, "data": [ { "id": "tx1b2c3d-e5f6-7890-abcd-ef1234567890", "invoiceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "invoiceRef": "SP-2024-001", "merchantId": "m1b2c3d4-e5f6-7890-abcd-ef1234567890", "txHash": "0xabc123def456...", "chain": "ethereum", "asset": "USDC", "amount": "100.00", "fee": "1.00", "merchantAmount": "99.00", "status": "confirmed", "type": "payment", "blockNumber": 19500000, "confirmedAt": "2024-03-11T10:05:30Z", "createdAt": "2024-03-11T10:05:00Z" }, { "id": "tx2b2c3d-e5f6-7890-abcd-ef1234567890", "invoiceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "invoiceRef": "SP-2024-001", "merchantId": "m1b2c3d4-e5f6-7890-abcd-ef1234567890", "txHash": "0xdef456abc789...", "chain": "ethereum", "asset": "USDC", "amount": "99.00", "fee": "0.00", "merchantAmount": "99.00", "status": "confirmed", "type": "forward", "blockNumber": 19500005, "confirmedAt": "2024-03-11T10:06:30Z", "createdAt": "2024-03-11T10:06:00Z" } ] }
Returns all on-chain transactions (both inbound payments and outbound forwards) associated with a specific invoice.
Your secret API key (sk_live_*). Keep this server-side only.
sk_live_*
Invoice ID (UUID)
Transaction list for the invoice
true
Show child attributes