---
title: "List transactions, newest first"
method: GET
path: "/transactions"
tags: ["transactions"]
---

# List transactions, newest first

`GET /transactions`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hevn-inc/apis/hevn-api/docs/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

Cursor-paged: pass `nextCursor` back as `cursor`. There is no offset and no total.

## Query parameters

- `type` string, nullable: Comma-separated transaction types
- `status` string, nullable: Comma-separated statuses
- `tag` string, nullable: Comma-separated tags
- `contactId` string, nullable
- `bankId` string, nullable
- `incomeOnly` boolean, nullable
- `q` string, nullable
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `limit` integer
- `cursor` string, nullable

## Headers

- `X-Hevn-Account` string, nullable: The client account to act for, as a `cl_…` id. Omit it to act as yourself.

## Response `200`

Successful Response

- PageTransactionView
  - `items` TransactionView[], required: Resources in this page, in stable server-defined order.
    - `id` string, nullable: Stable public identifier for this transaction.
    - `type` string, required: Public transaction type.
    - `status` 'pending' | 'rfi' | 'success' | 'failed' | 'refunded', required
    - `isIncome` boolean, required: Whether this transaction increases the selected account's balance.
    - `from` TransactionSideView
      - `amount` string, required: Amount on this side of the transaction.
      - `currency` string, required: ISO 4217 fiat code or supported digital-asset symbol.
      - `usdRate` string, nullable: Indicative conversion rate from this asset into USD.
    - `to` TransactionSideView
      - `amount` string, required: Amount on this side of the transaction.
      - `currency` string, required: ISO 4217 fiat code or supported digital-asset symbol.
      - `usdRate` string, nullable: Indicative conversion rate from this asset into USD.
    - `fee` TransactionSideView
      - `amount` string, required: Amount on this side of the transaction.
      - `currency` string, required: ISO 4217 fiat code or supported digital-asset symbol.
      - `usdRate` string, nullable: Indicative conversion rate from this asset into USD.
    - `account` 'USDC' | 'EURC' | 'RD' | 'USDC_ARB' | 'FDIC_USD' | 'FDIC_EUR' | 'KYC_CARDS'
    - `counterparty` string, nullable: Human-readable counterparty name.
    - `paymentReference` string, nullable: Reference or memo associated with the transfer.
    - `remitter` string, nullable: Originator information reported by the payment network.
    - `txHash` string, nullable: On-chain transaction hash associated with this ledger entry.
    - `tag` string, nullable: Public transaction classification tag.
    - `hasAttachments` boolean: Whether supporting documents are attached.
    - `createdAt` string, date-time, required: UTC timestamp when the transaction was created.
  - `nextCursor` string, nullable: Opaque cursor for the next page; absent when this is the final page.

## Other responses

- `422`: Request validation failed

## Changes

- **2026-11-12** `299a3aa6f521`: 2 warning, 2 info
  - added the new `FDIC_EUR` enum value to the `items/items/account/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `verification_not_applicable` enum value to the `error/code` response property for the response status `422`
  - removed the `phone_required` enum value from the `error/code` response property for the response status `422`
  - removed the `rail_requirements_unmet` enum value from the `error/code` response property for the response status `422`
- **2026-10-23** `a02795de2d2b`: 9 warning, 6 info
  - deleted the `header` request parameter `x-api-key`
  - added the new `client_already_linked` enum value to the `error/code` response property for the response status `422`
  - added the new `kyb_documents_processing` enum value to the `error/code` response property for the response status `422`
  - added the new `link_code_expired` enum value to the `error/code` response property for the response status `422`
  - …11 more
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `phone_in_use` enum value from the `error/code` response property for the response status `422`
- **2026-10-20** `bd6c9d69540e`: 1 warning
  - added the new `phone_in_use` enum value to the `error/code` response property for the response status `422`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hevn-inc/apis/hevn-api/changes/transactions/get.md)

---

[API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) - [All operations](https://skmtc.dev/hevn-inc/apis/hevn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hevn-inc/apis/hevn-api/revisions/299a3aa6f521?raw)