List transactions

Lists the association’s transaction records, newest first. Every accepted payment submission creates one; its id is the transactionRecordId returned in the 202 response.

GET /transactions

List transactions

cURL

curl --request GET \
  --url https://api.zeam.money/gw/v1/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'x-zeam-auth: <api-key>'

200

{
  "data": [
    {
      "transactionRecordId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "<string>",
      "idempotencyKey": "<string>",
      "type": "<string>",
      "failureReason": "<string>",
      "errorCode": "<string>",
      "sendAmount": 123,
      "originalSendAmount": 123,
      "sendCurrency": "<string>",
      "receiveAmount": 123,
      "receiveCurrency": "<string>",
      "fee": 123,
      "feeCurrency": "<string>",
      "exchangeRate": 123,
      "sendingAsset": "<string>",
      "walletPublicKey": "<string>",
      "isP2pTransfer": true,
      "destinationStellarAddress": "<string>",
      "beneficiaryId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "beneficiaryFirstName": "<string>",
      "beneficiaryLastName": "<string>",
      "connectorId": "<string>",
      "connectorName": "<string>",
      "method": "<string>",
      "destinationCountryIso": "<string>",
      "quoteId": "<string>",
      "stellarTxHash": "<string>",
      "externalReference": "<string>",
      "intentId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "completedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "nextCursor": "<string>",
    "hasMore": true
  }
}

Transaction Type Reference

These values describe the economic type of a transaction event. They are not accounting classifications; accounting treatment is the selected Chart-of-Accounts account on the linked journal entry.

Some values use spaces instead of underscores (e.g., INTERCOMPANY TRANSFER, CLAIM REWARD). Always reference the exact values below.

Transaction type	Description
DEPOSIT	Inbound receipt of funds
WITHDRAWAL	Outbound transfer of funds
SWAP	Exchange of one asset for another
BRIDGE	Cross-chain transfer
INTERCOMPANY TRANSFER	Transfer between legal entities
INTERNAL TRANSFER	Transfer within the same legal entity
FEE	Network gas, exchange, or service fee
MINTING	Creation of new tokens
STAKING_REWARD	Yield from staking
INVOICE	Payment received against a customer invoice
BILL	Payment against a vendor bill
CLAIM REWARD	Protocol or ecosystem reward claim
BORROW	Borrowing event
REPAYMENT	Loan repayment
RESERVES CHANGE	Treasury reserves adjustment
REALIZED_PNL	Realized profit or loss
NFT	NFT mint, sale, or transfer
SPAM	Spam/airdrop (auto-hides from accounting)
UNKNOWN	Type not yet determined, pending review

Authorizations

Authorization · string · header · required

Access token issued by POST /v1/auth/token.

x-zeam-auth · string · header · required

Application secret (the apiKey issued at registration), required on every request.

Query Parameters

status · string

Filter by lifecycle status (e.g. completed, failed, refund_completed).

startDate · string

Only records created on or after this time (RFC 3339 or YYYY-MM-DD).

endDate · string

Only records created on or before this time (RFC 3339 or YYYY-MM-DD).

walletId · string<uuid>

Only records for this wallet.

limit · integer · default: 20

Maximum items per page.

Required range: 1 <= x <= 100

cursor · string

Opaque pagination cursor from a previous response.

Response

200

application/json

A page of transaction records.

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes