Skip to main content
GET
List transactions
Only confirmed rows are returned. A pending or failed attempt never appears here. There’s no status filter to request otherwise; status on each item is always confirmed.
status is always confirmed. Where the sale’s money stands is mor_status: held until the hold period ends, available when payable, paid_out once paid to you, refunded after a refund, disputed while a dispute is open, charged_back when a dispute was lost. It is null for a sale that is not a card or bank-transfer sale. A won dispute returns the sale to refunded if it was refunded, paid_out if its money had already been paid to you, and available otherwise. disputed_at, dispute_won_at, charged_back_at and refunded_at say when; disputed_at stays set after a won dispute. A lost dispute and a refund send no webhook, so poll mor_status for a sale that received a dispute.created and no dispute.closed. Any other field not listed here is internal: treat it as forward-compatible and safe to ignore.

Invoices

Every settled inbound transaction has a matching invoice.

Webhooks

Get notified when a transaction settles, instead of polling this list.

Ask for a refund

Request a full refund of a sale; AgentaOS reviews it within 2 business days.

Authorizations

x-api-key
string
header
required

Your secret key, from app.agentaos.ai -> Settings -> Developers -> API Keys. The key's prefix is both its identity and its environment: sk_test_... (sandbox, free, no verification) or sk_live_... (real money, requires business verification). A missing or invalid key returns 401.

Query Parameters

direction
enum<string>
default:all
Available options:
all,
inbound,
outbound
from
string

ISO 8601 date or datetime, inclusive lower bound.

to
string

ISO 8601 date or datetime, inclusive upper bound.

fiatCurrency
enum<string>

Filter to rows settled/presented in this fiat currency.

Available options:
EUR,
USD
networks
string

Comma-separated CAIP-2 network IDs to filter by, e.g. eip155:8453,eip155:84532. Ignored if your API key is network-scoped.

limit
integer
default:20

Items per page, at most 1000. A larger value is treated as 1000.

Required range: 1 <= x <= 1000
offset
integer
default:0

Number of items to skip, for the next page.

Required range: x >= 0

Response

A page of transactions.

items
object[]
required
total
integer
required
hasMore
boolean
required