Wallet

Overview

Every Slimpay user has exactly one wallet — a single-balance account backed by a dedicated virtual bank account number. There's no concept of multiple linked accounts; funding, spending, and receiving all happen against this one balance.

GET /wallet Requires Auth

bash

curl https://app.slimpay.ng/api/v1/wallet \
  -H "Authorization: Bearer {token}"

GET /wallet

json

{
  "status": true,
  "data": {
    "balance": "6000.00",
    "ledger_balance": "6000.00",
    "virtual_account_bank": "Wema Bank",
    "virtual_account_number": "8123456789",
    "virtual_account_name": "SLIMPAY-OBINNA JOHN"
  }
}

Placeholder account number

Until NIN verification completes, virtual_account_number reads 0000000000 — this is not a real, fundable account. Check GET /kyc/status before showing a "fund your wallet" screen.

Lightweight reads

For frequent polling (e.g. a balance pill in a nav bar), use the lighter-weight endpoints instead of the full wallet object:

Method	Path	Returns
GET	`/wallet/balance`	Just the balance, formatted balance, and currency
GET	`/wallet/virtual-account`	Just the bank/number/name for the funding screen

GET /wallet/balance

GET /wallet/virtual-account

Transaction history

GET /transactions Requires Auth

Returns a paginated list of every transaction on the wallet — credits and debits, across every source (funding, bills, transfers, biller/school/payment-link receipts). Filter with query parameters:

bash

curl "https://app.slimpay.ng/api/v1/transactions?type=airtime&status=completed&page=1" \
  -H "Authorization: Bearer {token}"

GET /transactions

type query

status query

page query

Method	Path	Purpose
GET	`/transactions/{id}`	Get a single transaction
GET	`/transactions/{id}/receipt`	Get a printable receipt for a completed transaction

GET /transactions/{id}

id * path

GET /transactions/{id}/receipt

id * path

← Previous

Rate Limits

Identity Verification (NIN)