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

200 OK

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"
  }
]

401 UNAUTHORIZED

Returned when authentication headers are missing or invalid.

Response Format

{
    "statusCode": 401,
    "reason": "INVALID_CREDENTIALS",
    "details": {}
}

500 INTERNAL SERVER ERROR

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

Response Format

{
    "statusCode": 500,
    "reason": "SERVER_ERROR"
}