GET /transactions

GET /api/v1/remittance/transactions

Paginated list of your transactions.

Auth: Basic merchant_code:merchant_secret

Query params

Param	Type	Default	Description
limit	int	20	Max results per page (max 100).
page	int	1	1-indexed page number.
status	string	(all)	Filter by status: Submitted, Successful, Failed, Reversed, Hold.
operator	string	(all)	Filter by operator.
from	ISO date	(none)	Start date YYYY-MM-DD, inclusive.
to	ISO date	(none)	End date YYYY-MM-DD, inclusive.

Response (200 OK)

{
  "status": "success",
  "data": {
    "items": [
      {
        "reference":       "TXN_001",
        "transaction_id":  "IMT-IN-20260814-A1B2C3-D4E5",
        "status":          "Successful",
        "amount":          10.00,
        "currency":        "USD",
        "operator":        "mpesa",
        "customer_number": "243812345678",
        "subscriber_name": "MARIE KABILA",
        "created_at":      "2026-08-14T14:00:00.000000"
      }
    ],
    "pagination": { "page": 1, "limit": 20, "total": 1234, "pages": 62 }
  }
}

Tip: sync your ledger

For a full ledger sync, walk pages from newest to oldest until you hit your last-known transaction_id. Then flip to per-transaction polling of anything still Submitted or Hold.