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

# List transactions

`GET /gateway/all-transactions`

## Request

- Base URL: `https://api.agentaos.ai/api/v1`
- URL: `https://api.agentaos.ai/api/v1/gateway/all-transactions`
- Auth: API key in header `x-api-key`

One unified list of everything that moved money on your account: inbound payments (from checkouts and payment links) and outbound sends, across every rail (card, SEPA bank transfer, stablecoins on-chain), in one feed. Only `confirmed` rows are returned: a pending or failed attempt never appears here; `status` on each item is always `confirmed`.

## Query parameters

- `direction` 'all' | 'inbound' | 'outbound'
- `from` string
- `to` string
- `fiatCurrency` 'EUR' | 'USD'
- `networks` string
- `limit` integer
- `offset` integer

## Response `200`

A page of transactions.

- TransactionListResponse
  - `items` Transaction[], required
    - `id` string, uuid, required
    - `direction` 'inbound' | 'outbound', required
    - `amount` number, required: Presentment amount, currency units, in payment_token/settlement_token.
    - `payment_token` string, required: What the buyer paid with, e.g. EURC, card.
    - `settlement_token` string, required: What settled to your balance.
    - `status` 'confirmed', required: Always confirmed on this endpoint.
    - `payment_method` 'card' | 'sepa' | 'bank_transfer' | 'bridge' | 'wallet' | 'null', nullable, required: How the buyer actually paid, independent of network.
    - `payer_type` 'human' | 'agent', required
    - `payer_address` string, nullable, required: On-chain payer wallet. null for card/bank rails.
    - `tx_hash` string, nullable, required: null for card/bank rails, use vendor_reference there instead.
    - `vendor_reference` string, nullable, required: Off-chain audit reference (card-processor payment reference, bank reference). Mutually exclusive with tx_hash.
    - `network` string, required: `card` for a card payment, `bank_transfer` for a bank transfer, or a CAIP-2 network ID such as `eip155:8453` for a stablecoin payment.
    - `seller_of_record` 'aristokrates_ou' | 'merchant', required: aristokrates_ou for a Merchant of Record card sale, merchant for everything else.
    - `invoice_id` string, uuid, nullable, required: The matching invoice, joined for convenience. null for outbound rows.
    - `payment_link_id` string, uuid, nullable, required
    - `session_id` string, nullable, required
    - `description` string, nullable, required
    - `created_at` string, date-time, required
    - `money` TransactionMoney, required: Render-ready breakdown, computed server-side so you never sum this yourself. All values integer minor units in money.currency.
      - `currency` string, required: ISO 4217, upper-case.
      - `grossMinor` integer, required: Your ex-VAT sale base (feeMinor + netMinor). The buyer paid grossMinor + vatMinor.
      - `feeMinor` integer, required: AgentaOS's commission alone, 0 when none. Never includes VAT.
      - `vatMinor` integer, required: Destination VAT AgentaOS collected and remits as Merchant of Record. On top of grossMinor, never your revenue.
      - `netMinor` integer, required: What actually reaches your balance (grossMinor - feeMinor).
  - `total` integer, required
  - `hasMore` boolean, required

## Other responses

- `401`: Missing or invalid `x-api-key`.

---

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