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",
      "legs": [
        {
          "legIndex": 123,
          "walletPublicKey": "<string>",
          "destinationStellarAddress": "<string>",
          "sendingAsset": "<string>",
          "amount": 123
        }
      ]
    }
  ],
  "pagination": {
    "nextCursor": "<string>",
    "hasMore": true
  }
}

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. Values above 100 are treated as 100; a non-numeric or non-positive value is a 400.

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