Get user transactions

Get latest user transactions sorted by time.

GET /api/v1/transactions

Get user transactions

cURL

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

import requests

url = "https://api.hevn.finance/api/v1/transactions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.hevn.finance/api/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "transactions": [
    {
      "onchainTransactionId": "<string>",
      "type": "<string>",
      "name": "<string>",
      "time": "2023-11-07T05:31:56Z",
      "isIncome": true,
      "from": {
        "currency": "<string>",
        "amount": 123,
        "usdRate": 123,
        "source": "<string>"
      },
      "txHash": "<string>",
      "tag": "<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>"
      },
      "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>",
        "ibanNumber": "<string>",
        "beneficiaryName": "<string>",
        "bankAddress": "<string>",
        "currency": "<string>",
        "accountHolderFirstName": "<string>",
        "accountHolderLastName": "<string>",
        "accountHolderBusinessName": "<string>",
        "accountHolderAddress": {
          "streetAddress": "<string>",
          "addressLine2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "zip": "<string>"
        },
        "paymentReference": "<string>",
        "accountType": "sepa",
        "bic": "<string>"
      },
      "ibanTo": {
        "bankName": "<string>",
        "ibanNumber": "<string>",
        "beneficiaryName": "<string>",
        "bankAddress": "<string>",
        "currency": "<string>",
        "accountHolderFirstName": "<string>",
        "accountHolderLastName": "<string>",
        "accountHolderBusinessName": "<string>",
        "accountHolderAddress": {
          "streetAddress": "<string>",
          "addressLine2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "zip": "<string>"
        },
        "paymentReference": "<string>",
        "accountType": "sepa",
        "bic": "<string>"
      },
      "approved": "<string>",
      "hasAttachments": false
    }
  ],
  "summary": {
    "inflowUsd": 123,
    "inflowCount": 123,
    "outflowUsd": 123,
    "outflowCount": 123,
    "pendingInflowUsd": 123,
    "pendingInflowCount": 123,
    "pendingOutflowUsd": 123,
    "pendingOutflowCount": 123
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · default: Bearer <token> · 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

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