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

# List transactions

`GET /transactions`

List transactions

## Query parameters

- `type` 'payment' | 'transfer' | 'all' — Filter by transaction type.
- `limit` integer — Maximum results per page.
- `cursor` string — Cursor from the previous page.
- `counterpartyPartyId` string — Restrict results to transactions whose payment counterparty is this party.
- `walletId` string — Restrict results to transactions visible through this wallet.
- `customerPartyId` string — Restrict results to delegated activity performed for this customer, not activity involving it as a payment counterparty.
- `delegated` boolean — When true, return only transactions executed through an agent delegation (your connection-scoped feed).

## Headers

- `X-Agent-ID` string, nullable
- `X-Instance-ID` string, nullable

## Response `200`

Successful Response

- object
  - `data` object[], required
    - `type` 'transaction', required
    - `id` string, required — Transaction ID (txn_*).
    - `attributes` object, required
      - `amount` integer, required — Amount in cents.
      - `currency` string, required — Currency code.
      - `status` string, required — Transaction status.
      - `createdAt` string, required — When this transaction was created.
      - `transactionType` 'payment' | 'transfer', required — Transaction type.
      - `direction` 'INBOUND' | 'OUTBOUND', required — Direction relative to your party.
      - `description` string, nullable, required — Transaction description.
      - `updatedAt` string, nullable, required — When this transaction was last updated.
      - `expectedAvailableAt` string, nullable, required — Projected funds-available time, or null for payments and transfers without a projection.
    - `relationships` object, required
      - `sourceParty` object, required — Source party.
        - `data` object, nullable, required — Related resource identifier.
          - `type` 'party', required
          - `id` string, required
      - `destinationParty` object, required — Destination party.
        - `data` object, nullable, required — Related resource identifier.
          - `type` 'party', required
          - `id` string, required
      - `payment` object — Related payment, when accessible.
        - `data` object, required — Related resource identifier.
          - `type` 'payment', required
          - `id` string, required
      - `transfer` object — Related transfer, when accessible.
        - `data` object, required — Related resource identifier.
          - `type` 'transfer', required
          - `id` string, required
      - `wallet` object — Wallet through which this transaction is visible.
        - `data` object, required — Related resource identifier.
          - `type` 'wallet', required
          - `id` string, required
  - `meta` object, required
    - `pagination` object, required
      - `hasMore` boolean, required — Whether more results are available.
      - `nextCursor` string, nullable, required — Cursor for the next page, or null when there are no more results.

## Other responses

- `400` — Validation Error
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found. Returned when the resource does not exist, or when it exists but is not accessible to your account. The two cases are intentionally indistinguishable, so that resource IDs cannot be enumerated by probing.
- `409` — Conflict
- `422` — Validation Error
- `428` — Precondition Required
- `429` — Too Many Requests
- `500` — Internal Server Error
- `501` — Not Implemented
- `502` — Bad Gateway
- `503` — Service Unavailable

---

[API](https://skmtc.net/natural/apis/natural-api.md) · [All operations](https://skmtc.net/natural/apis/natural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/natural/natural-api/versions/0bb9c54b1f61/schema)