Skip to content

get

List public transactions

GET /api/v1/transactions

Authenticate with a bearer API key (rg_test_ in test mode, rg_live_ in live).

NameInTypeRequiredDescription
statusquerystringno
destinationquerystringnoFilter by recipient phone number or destination
networkquerystringnoFilter by telecom network code (e.g. mtn, airtel, glo, 9mobile)
servicequerystringnoFilter by service type (e.g. airtime, data)
fromquerystringnoFilter items created on or after this timestamp (RFC 3339)
toquerystringnoFilter items created on or before this timestamp (RFC 3339)
searchquerystringnoSearch by reference, client reference, or destination
cursorquerystringno
limitqueryintegerno

Request

 curl -X GET https://api.useroutegate.com/api/v1/transactions \
  -H "Authorization: Bearer $ROUTEGATE_API_KEY"

Response

200

{}

Error

default Error envelope

 {
  "success": false,
  "data": "<data>",
  "message": "<message>",
  "code": "<code>"
}

Give this to your coding agent

Read https://useroutegate.com/docs/api/public/listPublicTransactions.md and implement this call. Keep one Idempotency-Key per attempt at the same order, treat 202 as accepted and resolve the final state from the webhook. Amounts are integers in kobo.