---
title: "Get Wallets"
method: GET
path: "/pms/api/external/request/wallet/get-or-create/"
tags: ["Wallets"]
---

# Get Wallets

`GET /pms/api/external/request/wallet/get-or-create/`

Get existing wallet or create a new one for the authenticated business

## Headers

- `api-key` string, required
- `api-secret` string, required

## Response `200`

Wallets retrieved successfully

- GetWalletsResponse
  - `status` boolean — Request status
  - `message` string — Response message
  - `data` object
    - `id` string — Unique wallet ID
    - `business_id` string — Business identifier
    - `wallet_name` string — Wallet display name
    - `account_number` string — Wallet account number
    - `account_name` string — Wallet account name
    - `bank_name` string — Settlement bank name
    - `bank_code` string — Settlement bank code
    - `currency` string — Wallet currency
    - `status` string — Wallet status
    - `created_datetime` string, date-time — Wallet creation timestamp
    - `balance` object
      - `available_balance` string — Available balance
      - `ledger_balance` string — Ledger balance

---

[API](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api.md) · [All operations](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payvessel/payvessel-value-added-services-api/revisions/31040a9358ef/schema)