Skip to main content
Transaction IDs use txn_... opaque tokens.

Authentication

Authorization: Bearer sk_live_...
Scope: transactions:read (legacy payments:read is no longer accepted).

List transactions

GET /v1/transactions Cursor pagination. Optional filters: invoice_id (inv_...), type, status. Rate limit: read bucket (observe).

Retrieve transaction

GET /v1/transactions/{id} Path id: txn_....

Lookup by hash

GET /v1/transactions/by-hash/{transactionHash} On-chain hash lookup within the store scope.

Invoice transactions

GET /v1/invoices/{id}/transactions Lists transactions linked to invoice inv_.... Requires transactions:read.

Example (Node.js)

const res = await fetch(
  `https://api.meum.io/v1/invoices/${invoiceId}/transactions`,
  { headers: { Authorization: `Bearer ${apiKey}` } }
);
Money fields (amount) are always strings in JSON responses.