Transactions

GET /v1/transactions

Returns paginated transaction history for the wallet.

Requires scope: transactions:read

Request

curl "https://api.nuez.app/v1/transactions?limit=20" \
  -H "Authorization: Bearer nz_sk_live_..."

Query parameters

Parameter	Type	Default	Description
limit	number	20	Transactions per page. Max: 100.
cursor	string	—	Pagination cursor from previous response.

Response

{
  "transactions": [
    {
      "id": "txn_01HXYZ...",
      "type": "debit",
      "amount": 5000,
      "destination": "proveedor.empresa",
      "description": "Invoice #42",
      "status": "completed",
      "created_at": "2026-04-23T14:32:01Z"
    },
    {
      "id": "txn_01HABC...",
      "type": "credit",
      "amount": 100000,
      "origin": "0000003100010000123456",
      "description": "Wallet top-up",
      "status": "completed",
      "created_at": "2026-04-22T10:00:00Z"
    }
  ],
  "next_cursor": "cur_01HDEF...",
  "has_more": true
}

Pagination

If has_more is true, pass next_cursor as the cursor parameter in your next request to fetch the following page.