Get user transactions

Get latest user transactions sorted by time.

GET /api/v1/transactions

Get user transactions

cURL

curl --request GET \
  --url https://api.example.com/api/v1/transactions \
  --header 'Authorization: Bearer <token>'

200

{
  "transactions": [
    {
      "type": "<string>",
      "name": "<string>",
      "time": "2023-11-07T05:31:56Z",
      "status": "pending",
      "isIncome": true,
      "from": {
        "currency": "<string>",
        "amount": 123,
        "usdRate": 123,
        "source": "<string>"
      },
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "onchainTransactionId": "<string>",
      "txHash": "<string>",
      "tag": "<string>",
      "spendLineId": "<string>",
      "to": {
        "currency": "<string>",
        "amount": 123,
        "usdRate": 123,
        "source": "<string>"
      },
      "fee": {
        "currency": "<string>",
        "amount": 123,
        "usdRate": 123,
        "source": "<string>"
      },
      "destinationChainId": "<string>",
      "usdBalanceAfter": 123,
      "card": {
        "name": "<string>",
        "label": "<string>",
        "merchant": "<string>",
        "merchantIcon": "<string>",
        "category": "<string>"
      },
      "invoice": {
        "invoiceNumber": "<string>",
        "periodStart": "2023-12-25",
        "periodEnd": "2023-12-25"
      },
      "userFrom": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "email": "<string>",
        "name": "<string>",
        "avatarUrl": "<string>",
        "address": "<string>"
      },
      "userTo": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "email": "<string>",
        "name": "<string>",
        "avatarUrl": "<string>",
        "address": "<string>"
      },
      "walletFrom": {
        "address": "<string>",
        "chainId": "<string>"
      },
      "walletTo": {
        "address": "<string>",
        "chainId": "<string>"
      },
      "ibanFrom": {
        "bankName": "<string>",
        "accountHolderType": "individual",
        "beneficiaryName": "<string>",
        "bankAddress": {
          "addressLine1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postalCode": "<string>",
          "country": "<string>"
        },
        "currency": "<string>",
        "accountHolderFirstName": "<string>",
        "accountHolderLastName": "<string>",
        "accountHolderBusinessName": "<string>",
        "accountHolderAddress": {
          "streetAddress": "<string>",
          "addressLine2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "AF",
          "zip": "<string>"
        },
        "relationship": "employee",
        "businessIndustry": "<string>",
        "paymentReference": "<string>",
        "accountType": "sepa",
        "ibanNumber": "<string>",
        "bic": "<string>"
      },
      "ibanTo": {
        "bankName": "<string>",
        "accountHolderType": "individual",
        "beneficiaryName": "<string>",
        "bankAddress": {
          "addressLine1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postalCode": "<string>",
          "country": "<string>"
        },
        "currency": "<string>",
        "accountHolderFirstName": "<string>",
        "accountHolderLastName": "<string>",
        "accountHolderBusinessName": "<string>",
        "accountHolderAddress": {
          "streetAddress": "<string>",
          "addressLine2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "AF",
          "zip": "<string>"
        },
        "relationship": "employee",
        "businessIndustry": "<string>",
        "paymentReference": "<string>",
        "accountType": "sepa",
        "ibanNumber": "<string>",
        "bic": "<string>"
      },
      "approved": "<string>",
      "remitter": "<string>",
      "paymentReference": "<string>",
      "traceNumber": "<string>",
      "hasAttachments": false
    }
  ],
  "summary": {
    "inflowUsd": 123,
    "inflowCount": 123,
    "outflowUsd": 123,
    "outflowCount": 123,
    "pendingInflowUsd": 123,
    "pendingInflowCount": 123,
    "pendingOutflowUsd": 123,
    "pendingOutflowCount": 123
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-api-key · string | null

Query Parameters

limit · integer · default: 50

Required range: 1 <= x <= 200

offset · integer · default: 0

Required range: x >= 0

sortBy · enum<string> · default: date

Field to sort the transaction list by.

Available options: date, amount

sortOrder · enum<string> · default: desc

Sort direction.

Available options: asc, desc

type · string | null

Comma-separated transaction types

incomeOnly · boolean | null

tag · string | null

Comma-separated tags

status · string | null

Comma-separated unified statuses

contactId · string | null

Comma-separated contact UUIDs

bank_account_id · string | null

Comma-separated bank account UUIDs

bankAccountId · string | null

Comma-separated bank account UUIDs

cardId · string | null

Comma-separated Card UUIDs

fromDate · string<date-time> | null

toDate · string<date-time> | null

asOf · string<date> | null

Reporting-date cutoff (YYYY-MM-DD). Caps results at the end of that day; ignored when toDate is set.

hasInvoice · boolean | null

True → only transactions linked to an invoice; False → only those without one; omitted → no filter.

q · string | null

Free-text search across description, merchant, tag, hash/wallet, contact name, counterparty user, invoice contractor, IBAN, and exact amount. Min 2 chars; values shorter are ignored.

Response

200

application/json

Successful Response

Unified transaction list response.

transactions · UnifiedTransactionItem · object[] · required

Show child attributes

summary · TransactionSummary · object | null

Aggregate volumes and counts over the filtered transaction set.

Computed without LIMIT/OFFSET — represents the entire filtered scope, not just the current page. Returned only on the first page (offset=0); subsequent pages omit it since it doesn't change with pagination.

Show child attributes