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

# List transactions

`GET /transactions`

List transactions visible to your party.

## Query parameters

- `type` 'payment' | 'transfer' | 'all'
- `limit` integer — Results per page
- `cursor` string — Pagination cursor from previous response
- `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 customer activity executed on behalf of this customer party. This maps to the transaction subject party, not the payment counterparty.
- `delegated` boolean — When true, restrict results to transactions executed through an agent delegation (agentDelegationId IS NOT NULL) — the 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 handle (txn_xxx)
    - `attributes` object, required — Resource attributes
      - `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: payment | transfer
      - `direction` 'INBOUND' | 'OUTBOUND', required — Direction: INBOUND | OUTBOUND
      - `description` string, nullable, required — Payment description
      - `updatedAt` string, nullable, required — When this transaction was last updated
      - `expectedAvailableAt` string, nullable, required — Projected funds-available time for transfers. Null when no projection exists and null for payments.
    - `relationships` object, required — Resource relationships
      - `sourceParty` object, required — Source party
        - `data` object, nullable, required — Related resource identifier
          - `type` 'party', required — Resource type
          - `id` string, required
      - `destinationParty` object, required — Destination party
        - `data` object, nullable, required — Related resource identifier
          - `type` 'party', required — Resource type
          - `id` string, required
      - `payment` object — Payment that produced this transaction. Present only when the authenticated caller can access the payment resource.
        - `data` object, required — Related resource identifier
          - `type` 'payment', required — Resource type
          - `id` string, required
      - `transfer` object — Transfer that produced this transaction. Present only when the authenticated caller can access the transfer resource.
        - `data` object, required — Related resource identifier
          - `type` 'transfer', required — Resource type
          - `id` string, required
      - `wallet` object — Wallet whose ledger row made this transaction visible.
        - `data` object, required — Related resource identifier
          - `type` 'wallet', required — Resource type
          - `id` string, required
  - `meta` object, required
    - `pagination` object, required
      - `hasMore` boolean, required
      - `nextCursor` string, nullable, required

## 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.dev/natural/apis/natural-api.md) · [All operations](https://skmtc.dev/natural/apis/natural-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/natural/natural-api/revisions/8cc2aed45847/schema)