Get wallet

GET

https://api.staging.vrtx.sa/cl/v1/wallets/{wallet_id}

Last modified:2025-12-03 07:59:44

Retrieve detailed information about a specific wallet by its unique walletId.
This endpoint returns full metadata including the wallet’s balance, account number, label, currency, linked business, and timestamps.
It’s commonly used to view wallet status, confirm account details before transfers, or display wallet information in dashboards.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.staging.vrtx.sa/cl/v1/wallets/622ea233-3f21-450f-8758-e42cdd4e5e74' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Wallet

{
    "id": "622ea233-3f21-450f-8758-e42cdd4e5e74",
    "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
    "name": "Wallet for marketplace revenue",
    "label_id": null,
    "external_reference": "WALLET-Revenue-123",
    "can_overdraft": false,
    "overdraft_limit_minor": 0,
    "status": "ACTIVE",
    "account_number": "054200003017",
    "currency": "SAR",
    "balance": "0.00",
    "created_at": "2025-10-25T07:13:51.196Z",
    "updated_at": "2025-10-25T07:13:51.196Z"
}

Modified at 2025-12-03 07:59:44

Update wallet

Get wallet balance