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

# List transactions

`GET /transactions`

List transactions for the authenticated user with cursor-based pagination.

## Query parameters

- `cursor` string — Opaque cursor from a previous response
- `limit` integer — Items per page (1-100, default 50)
- `account_id` string, uuid — Filter by account ID

## Response `200`

Transactions retrieved.

- object
  - `data` object[], required
    - `id` string, required
    - `account_id` string, required
    - `account_name` string, required
    - `amount` number, required
    - `amount_absolute` number, required
    - `cash_flow_direction` string, required
    - `is_internal_transfer` boolean, required
    - `pending` boolean, required
    - `date_posted` string, required
    - `date_authorized` string, nullable, required
    - `category_label` string, required
    - `category_tier1` string, required
    - `category_tier2` string, nullable, required
    - `counterparty_name` string, required
    - `counterparty_logo_url` string, nullable, required
    - `original_description` string, nullable, required
  - `has_more` boolean, required
  - `cursor` string, nullable, required — Opaque cursor for the next page, null if no more pages
  - `count` integer, required — Number of items in the current page
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required

## Other responses

- `400` — Invalid cursor.

---

[API](https://skmtc.net/yoshi-ai-dev/apis/yoshi-api.md) · [All operations](https://skmtc.net/yoshi-ai-dev/apis/yoshi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yoshi-ai-dev/yoshi-api/revisions/79b8247d58a2/schema)