API reference

Transactions

The ledger. Every entry that moved money, in or out.

GET{BASE_URL}/transactions

List ledger entries.

Request

curl "{BASE_URL}/transactions?direction=inward&currency=XAF&limit=50&offset=0" \
  -H "X-Api-Key: <your-api-key>"

Optional filters: direction (inward or outward), currency, method_code, from_date, to_date, limit (max 200), offset.

Response · 200 OK

{
  "items": [
    {
      "id": "...",
      "direction": "inward",
      "type": "payment",
      "amount": "11800",
      "currency": "XAF",
      "balance_before": "968200",
      "balance_after": "980000",
      "source_type": "payment",
      "source_id": "550e8400-...",
      "created_at": "2026-06-27T09:01:42Z"
    }
  ],
  "total": 143,
  "limit": 50,
  "offset": 0
}

Field	Meaning
`direction`	`inward` credited your wallet, `outward` debited it
`balance_before` / `balance_after`	Wallet balance either side of this entry
`source_type` / `source_id`	What caused the entry, and its identifier

✓

This is your reconciliation source. Join source_id to your own payment and payout records. See Reconciliation.

Maly Payments API v1 · Documentation 1.1 · July 2026
Maly Tech Ltd. This guide is provided for information. Where it differs from your signed agreement, the agreement applies.