API reference

List wallets

Get all user wallets. Request fields, response examples and integration guidance.

GET /wallets

Example request

Server-side HTTP request
curl --request GET \
  --url "https://api.strongmb.ng/v1/wallets" \
  --header "Authorization: Bearer $STRONGMB_API_KEY" \
  --header "Accept: application/json"

Returns all wallets associated with the authenticated user including balances, limits, and status.

JSON Response
{
  "status": true,
  "message": "Wallet details retrieved successfully",
  "data": {
    "wallets": [
      {
        "uuid": "a2ae313c-074b-49eb-9660-7ef4c6408fcf",
        "type": "primary_ngn",
        "currency": "NGN",
        "balance": 885459,
        "locked_balance": 0,
        "tier": "tier 1",
        "transaction_limit": 100000,
        "balance_limit": 500000,
        "status": "normal",
        "updated_at": "2026-09-21 00:51:37.898447+01"
      },
      {
        "uuid": "e79f58e4-55e7-4641-81e7-9b4c2378a5cd",
        "type": "sell_link_ngn",
        "currency": "NGN",
        "balance": 0,
        "locked_balance": 0,
        "tier": "tier 1",
        "transaction_limit": 100000,
        "balance_limit": 500000,
        "status": "normal",
        "updated_at": "2026-03-25 03:37:25.072776+01"
      }
    ]
  },
  "metadata": {
    "code": "WALLET_DETAILS_RETRIEVED",
    "timestamp": 1789951389,
    "trace_id": "D9D6FD0311"
  }
}

Response fields and types

The wallets array contains the wallets belonging to the authenticated user. Each [] field describes one wallet. The default primary wallet is primary_ngn.

Field pathJSON typeMeaning and handling
statusbooleanWhether this API request succeeded. Check the HTTP status and metadata.code when handling errors.
messagestringHuman-readable description of the result. Use metadata.code for programmatic error handling instead of parsing this text.
dataobjectResponse data. Check the result before reading nested fields; an error may return null or validation details.
data.walletsarrayArray of wallets belonging to the authenticated account. Iterate the returned array rather than assuming one wallet.
data.wallets[]objectOne entry in the wallets array. Its nested fields are documented below.
data.wallets[].uuidstringUnique identifier of the wallet record.
data.wallets[].typestringWallet type. primary_ngn is the default primary wallet; other wallets can include sell_link_ngn.
data.wallets[].currencystringCurrency code, such as NGN for Nigerian naira.
data.wallets[].balancenumberWallet balance as returned by this endpoint. Use decimal-safe arithmetic for money.
data.wallets[].locked_balancenumberPortion of wallet funds reported as locked. Do not treat locked funds as freely spendable.
data.wallets[].tierstringAccount tier label. It can affect the limits shown on wallet records.
data.wallets[].transaction_limitinteger | nullPer-transaction limit reported for this wallet. A null value means no limit is set.
data.wallets[].balance_limitinteger | nullMaximum wallet balance reported for this tier. A null value means no limit is set.
data.wallets[].statusstringWallet status, such as normal or PND. This describes the wallet, not a purchase outcome.
data.wallets[].updated_atstringLast-update timestamp for this record, returned as a string.
metadataobjectDiagnostic information about the response.
metadata.codestringMachine-readable result code. Use it to distinguish validation, authentication and service errors.
metadata.timestampintegerUnix timestamp in seconds associated with the response.
metadata.trace_idstringCorrelation identifier for troubleshooting. Retain it with a redacted request when contacting support.

Questions? Let’s work through them.

Having an issue or need help with your integration? Join the Strongmb Slack community to ask questions and get assistance from our team and other developers.

Keep API keys and customer details private when sharing examples.

Experiencing a service issue? Check Strongmb’s service status for incident updates.

Join our Slack community

Did this page help you?

Search documentation