Skip to main content
GET
/
v1
/
invoices
/
{id}
/
transactions
List invoice transactions
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",
      "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "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",
      "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.swiftpay.finance/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Swift-Key
string
header
required

Your secret API key (sk_live_*). Keep this server-side only.

Path Parameters

​
id
string<uuid>
required

Invoice ID (UUID)

Response

Transaction list for the invoice

​
success
enum<boolean>
Available options:
true
​
data
object[]