Get Wallet

GET

https://api.sandbox.vrtx.sa/customers/{customer_id}

Last modified:2026-08-23 18:31:25

Retrieves a single customer (vrtx wallet) owned by the authenticated business.

A customer_id that belongs to another business is reported as CUSTOMER_NOT_FOUND, identically to one that does not exist — confirming the id is real would itself leak across businesses.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Responses

🟢200

application/json

Default Response

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠405

🟠409

🟠410

🟠422

🟠429

🔴500

🔴501

🔴503

🔴504

🔴505

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.sandbox.vrtx.sa/customers/' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "customer_id": "cust_00154344290ab",
    "external_reference": "E0016",
    "full_name": "Ahmed Al-Otaibi",
    "mobile_number": "9665XXXX4290",
    "status": "active",
    "wallet_account_number": "000100012345",
    "wallet_iban": "SA110292929000000100012345",
    "currency": "SAR",
    "created_at": "2026-06-14T09:32:03.907Z"
}

Modified at 2026-08-23 18:31:25

List Wallets