Skip to main content
GET
/
v1
/
transactions
List Transactions
curl --request GET \
  --url https://api.example.com/v1/transactions
{
  "transactions": [
    {
      "id": "<string>",
      "type": "<string>",
      "status": "<string>",
      "amount": 123,
      "currency": "<string>",
      "description": {},
      "merchant_name": {},
      "created_at": "<string>",
      "completed_at": {}
    }
  ],
  "total_count": 123,
  "has_more": true
}
Returns a paginated list of all transactions for the project linked to the authenticated API token. Results are ordered by creation time, most recent first.
Requires a bearer token with the read permission.

​
Query Parameters

​
limit
integer
default:"50"
Number of transactions to return. Min 1, max 200.
​
offset
integer
default:"0"
Number of transactions to skip. Min 0.

​
Response

​
transactions
array
required
Array of transaction objects.
​
total_count
integer
required
Total number of transactions across all pages.
​
has_more
boolean
required
Whether there are more transactions beyond the current page.

​
Transaction Types

TypeDescription
fundFiat funding added to the project
paymentOutbound ACH payment to an external bank account
x402_paymentx402 protocol payment to a URL
usdc_transferOn-chain USDC transfer to an external wallet
usdc_fundUSDC deposit received on-chain
platform_feePlatform fee charged on a transaction
fiat_withdrawalFiat withdrawal from the project

​
Examples

curl "https://api.unwall.xyz/v1/transactions?limit=10&offset=0" \
  -H "Authorization: Bearer aw_live_xxxxxxxxxxxx"
Response (200 OK)
{
  "transactions": [
    {
      "id": "tx_x402_001",
      "type": "x402_payment",
      "status": "completed",
      "amount": 500000,
      "currency": "usdc",
      "description": "x402 payment to https://api.example.com/v1/data",
      "merchant_name": "api.example.com",
      "created_at": "2026-03-11T16:30:00Z",
      "completed_at": "2026-03-11T16:30:05Z"
    },
    {
      "id": "tx_usdc_002",
      "type": "usdc_transfer",
      "status": "processing",
      "amount": 50000000,
      "currency": "usdc",
      "description": "Vendor payment",
      "merchant_name": null,
      "created_at": "2026-03-11T14:00:00Z",
      "completed_at": null
    },
    {
      "id": "tx_fund_003",
      "type": "usdc_fund",
      "status": "completed",
      "amount": 100000000,
      "currency": "usdc",
      "description": "USDC deposit",
      "merchant_name": null,
      "created_at": "2026-03-10T09:00:00Z",
      "completed_at": "2026-03-10T09:00:30Z"
    }
  ],
  "total_count": 3,
  "has_more": false
}