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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200OK

application/json

Body

Example

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

🟠401Unauthorized

🟠403Forbidden

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

Update wallet

Get wallet balance