Skip to main content
GET
/
wallet
/
transactions
/
wallet
/
{walletId}
Transactions by wallet
curl --request GET \
  --url https://api.cartevo.co/api/v1/wallet/transactions/wallet/{walletId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": [
    {
      "id": "7d1cdfa3-9904-4a17-bce5-092554170c0e",
      "amount": 5000,
      "amount_with_fee": 5100,
      "fee_amount": 100,
      "net_amount": 5000,
      "currency": "XAF",
      "status": "PENDING",
      "type": "FUND",
      "category": "WALLET",
      "operator": "mtn",
      "phone_number": "650695112",
      "reference": "<string>",
      "order_id": "<string>",
      "wallet_balance_before": 10000,
      "wallet_balance_after": 15000,
      "created_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 15,
    "totalPages": 1
  }
}

​
Overview

GET /wallet/transactions/wallet/{walletId} returns the full transaction history for one wallet — fundings, deposits, payouts, internal transfers, and any fees deducted. The response is paginated.

​
When to use it

  • Render a per-wallet activity feed in your dashboard.
  • Reconcile a wallet’s balance against its transaction history.
  • Investigate a missing or unexpected balance change.

​
Prerequisites

  • The wallet must belong to your company.

​
Request

​
Headers

NameRequiredDescription
AuthorizationYesBearer <access_token>

​
Path parameters

NameTypeDescription
walletIdstringWallet ID (UUID).

​
Query parameters

NameTypeDefaultDescription
pageinteger11-indexed page number.
limitinteger10Items per page (max ~100).

​
Response

​
200 — Success

{
  "success": true,
  "statusCode": 200,
  "message": "20 items retrieved successfully",
  "data": [
    {
      "id": "txn_5b7c9d2e4f6a8b1c3d5e7f9a",
      "amount": 5000,
      "amount_with_fee": 5050,
      "fee_amount": 50,
      "net_amount": 5000,
      "currency": "XAF",
      "status": "SUCCESS",
      "type": "FUND",
      "category": "WALLET",
      "operator": "mtn",
      "phone_number": "237670000000",
      "reference": "FUND-2026-001",
      "order_id": "AFB-202605091015-XYZ",
      "wallet_balance_before": 120000,
      "wallet_balance_after": 125000,
      "created_at": "2026-05-09T10:15:00.000Z",
      "completed_at": "2026-05-09T10:15:42.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 47,
    "totalPages": 5
  }
}

​
Field reference

FieldTypeDescription
idstringTransaction ID.
amountnumberTransaction amount in currency.
amount_with_feenumberamount + fee_amount. The total movement against the wallet.
fee_amountnumberFee deducted (0 if no fee applies).
net_amountnumberNet amount credited or debited after fees.
typestringOne of FUND, WITHDRAW, DEPOSIT, TRANSFER, FEE, REFUND.
categorystringAlways "WALLET" for this endpoint.
statusstringOne of PENDING, PROCESSING, SUCCESS, FAILED.
wallet_balance_before / wallet_balance_afternumberWallet balance immediately before / after this transaction settled. null for PENDING.
referencestringThe trxId you supplied (or auto-generated).
order_idstringReference at the upstream payment provider.
completed_atstringWhen the transaction reached a terminal state. null for non-terminal.

​
Error responses

StatusTrigger
404Wallet does not exist or belongs to another company.

​
Code examples

cURL
curl -G https://api.cartevo.co/api/v1/wallet/transactions/wallet/w1a2b3c4-d5e6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=50"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
walletId
string<uuid>
required

Query Parameters

​
page
integer
Example:

1

​
limit
integer
Example:

20

Response

A list of transactions for the specified wallet.

​
success
boolean
Example:

true

​
statusCode
integer
Example:

200

​
message
string
Example:

"Data retrieved successfully"

​
data
object[]
​
pagination
object