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

# GET /transactions

`GET /transactions`

Returns historical transactions for the authenticated user. An optional time range may be supplied via `start_timestamp_ns` / `end_timestamp_ns`; when both bounds are given, `end_timestamp_ns` must be greater than `start_timestamp_ns`. Inverted ranges are rejected with a 400.

## Query parameters

- `account_id` string, nullable
- `transaction_types` string[], required
- `end_timestamp_ns` integer, nullable
- `start_timestamp_ns` integer, nullable
- `cursor` string, nullable
- `limit` integer, nullable
- `sort_ts` 'asc' | 'desc' — Sort order/direction. - `asc`: ascending order per field type (e.g. lexicographic, numeric, etc.) - `desc`: descending order per field type

## Response `200`

List of transactions

- GetTransactionsResponse — Page metadata for cursor-paged responses. This is intended for response bodies (not query params).
  - `limit` integer, nullable
  - `next_cursor` string, nullable
  - `total_count` integer, nullable
  - `transactions` Transaction[], required
    - `account_id` string, required
    - `amount` string, required
    - `event_id` string, required
    - `initiated_by_user_id` string, nullable — Actor of record — the user who initiated the transaction. Present only for directly-initiated kinds (`withdrawal`, `adjustment`); `None` for order-derived and system-generated transactions.
    - `reference_id` string, nullable
    - `symbol` string, required
    - `timestamp` string, date-time, required
    - `transaction_type` string, required

## Other responses

- `400` — Time range inverted (end_timestamp_ns <= start_timestamp_ns)

---

[API](https://skmtc.net/architect/apis/ax-api-gateway.md) · [All operations](https://skmtc.net/architect/apis/ax-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/architect/ax-api-gateway/versions/2955c31c524d/schema)