Skip to main content
GET
/
transactions
Fetch transactions
curl --request GET \
  --url https://gateway.useyala.com/api/public/transactions \
  --header 'x-api-key: <api-key>'
{
  "statusCode": 200,
  "message": "success",
  "data": [
    "<unknown>"
  ],
  "meta": {
    "total": 199,
    "page": 1,
    "limit": 10,
    "size": 5
  }
}

​
Overview

Fetch a paginated list of wallet transactions. Transactions represent all debit and credit movements across your Yala wallets, including payouts, top-ups, and internal transfers.

​
Query Parameters

ParameterTypeRequiredDescription
filter[payoutRef]stringNoFilter transactions by payout reference

​
Usage Notes

  • Returns all transaction types (DEBIT, CREDIT) across all your wallets.
  • Filter by payoutRef to see all transactions related to a specific payout.
  • Each transaction includes wallet details, balance before/after, and transaction metadata.
  • Use the reference field to link transactions to payouts or other operations.
Transaction amounts are negative for debits and positive for credits. Use balanceBefore and balanceAfter to verify wallet balance changes.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
filter[payoutRef]
string

Filter transactions by payout reference

Example:

"88WWRnkRWu"

Response

A successful response

​
statusCode
integer
Example:

200

​
message
string
Example:

"success"

​
data
any[]
​
meta
object