List Wallets

Use this endpoint to retrieve all wallets associated with your TemboPlus account, including both collection and disbursement wallets across all supported currencies.

Endpoint

GET /wallet

Request

Headers

  • Content-Type* — Must be application/json

  • x-account-id* — Your unique TemboPlus account identifier

  • x-secret-key* — Your TemboPlus API secret key

  • x-request-id* — Unique UUID per request for tracing

Body Parameters

No request body is required.


Responses

chevron-right200 OKhashtag

Returns an array of all wallets linked to your account. Each wallet includes balance, currency, and type information.

Response Format

[
  {
    "accountNo": "9000112233",
    "accountName": "ACME CORP",
    "type": "DEFAULT DISBURSEMENT",
    "balance": 4500000,
    "currency": "TZS",
    "countryCode": "TZ"
  },
  {
    "accountNo": "9000445566",
    "accountName": "ACME CORP - COLLECTION",
    "type": "DEFAULT COLLECTION",
    "balance": 1250000,
    "currency": "TZS",
    "countryCode": "TZ"
  },
  {
    "accountNo": "8000778899",
    "accountName": "ACME CORP - KES COLLECTION",
    "type": "COLLECTION",
    "balance": 75000,
    "currency": "KES",
    "countryCode": "KE"
  },
  {
    "accountNo": "8000334455",
    "accountName": "ACME CORP - KES DISBURSEMENT",
    "type": "DISBURSEMENT",
    "balance": 32000,
    "currency": "KES",
    "countryCode": "KE"
  }
]
chevron-right401 UNAUTHORIZEDhashtag

Returned when authentication headers are missing or invalid.

Response Format

{
    "statusCode": 401,
    "reason": "INVALID_CREDENTIALS",
    "details": {}
}
chevron-right500 INTERNAL SERVER ERRORhashtag

Indicates a temporary issue within TemboPlus. Retry later or contact TemboPlus Support with your x-request-id.

Response Format

Last updated