---
title: "GET /transactions"
method: GET
path: "/transactions"
tags: ["transactions"]
---

# GET /transactions

`GET /transactions`

## Request

- Base URL: `https://api.betteroff.finance`
- URL: `https://api.betteroff.finance/transactions`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Query parameters

- `limit` string
- `cursor` string
- `sort` string
- `period` string
- `from` string
- `to` string
- `account` string
- `category` string
- `subcategory` string
- `merchant` string
- `type` string
- `source` string
- `q` string
- `transfers` string
- `sweeps` string

## Response `200`

Success

- object
  - `txns` object[], required
    - `transaction` object, required
      - `id` string, uuid, required
      - `name` string, required
      - `merchantId` string, uuid, nullable, required
      - `merchantName` string, nullable, required
      - `merchantLogo` string, nullable, required
      - `merchantWebsite` string, nullable, required
      - `amount` string, required: Decimal string in `currency`. Positive is money leaving the account; negative is money coming in.
      - `currency` string, required
      - `quantity` string, nullable, required: Decimal string.
      - `symbol` string, nullable, required
      - `date` string, date-time, required
      - `category` string, nullable, required
      - `subcategory` string, nullable, required
      - `accountId` string, uuid, required
      - `transactionType` string, required
      - `transactionClass` string, nullable, required
      - `status` string, required
      - `paymentMethod` string, nullable, required
      - `feeUsd` string, nullable, required: Decimal string.
      - `nativeAmount` string, nullable, required: Decimal string.
      - `nativeCurrency` string, nullable, required
      - `fxRateUsed` string, nullable, required: Decimal string.
      - `settledAt` string, date-time, nullable, required
      - `isManual` boolean, required
      - `notes` string, nullable, required
      - `decodedType` string, nullable, required
      - `decodedDescription` unknown, required
      - `txGroupId` string, uuid, nullable, required
      - `legRole` string, required
      - `counterparties` object[], nullable, required
      - `receipt` object, nullable, required
        - `status` string, required
        - `source` string, required
        - `note` string, nullable, required
        - `updatedAt` string, nullable, required
      - `updatedAt` string, date-time, required: Send as If-Match (epoch ms or the ETag) on the next write.
    - `account` object, nullable, required
      - `id` string, uuid, required
      - `connectionId` string, uuid, nullable, required
      - `name` string, required
      - `mask` string, nullable, required
      - `institutionName` string, nullable, required
      - `institutionLogo` string, nullable, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required: Pass as `cursor` with the same filters and sort for the next page.

## Other responses

- `default`: Problem details

---

[API](https://skmtc.dev/betteroff/apis/betteroff-api.md) · [All operations](https://skmtc.dev/betteroff/apis/betteroff-api/llms.txt) · [OpenAPI document](https://skmtc.dev/betteroff/apis/betteroff-api/revisions/bc858c8d428d?raw)