Skip to main content
GET
/
api
/
v1
/
transactions
Get user transactions
curl --request GET \
  --url https://api.hevn.finance/api/v1/transactions \
  --header 'Authorization: Bearer <token>'
{
  "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
  }
}

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

Successful Response

Unified transaction list response.

​
transactions
UnifiedTransactionItem · object[]
required
​
summary
TransactionSummary · object

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.