Skip to content
KasblyKasbly Docs

Get wallet detail (balance, currency, customer)

GET
/api/v1/wallets/{id}
curl --request GET \
  --url https://api.dokanmazad.com/api/v1/wallets/cmoabcde000001ny11aabbcc0 \
  --header 'X-API-Key: <X-API-Key>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Wallet ID OR customer CUID — the endpoint accepts either

Example
cmoabcde000001ny11aabbcc0

Responses

Section titled “Responses”

200

Section titled “200”

Success

Media typeapplication/json
object
success
required
boolean
data
required
meta
object
page
integer
limit
integer
total
integer
totalPages
integer
data
required
object
id
required

Wallet CUID

string
customerId
required

Owner customer CUID

string
balance
required

Current available balance

number
currency
required

Wallet currency (USD | AED | KRW)

string
totalCredited

Lifetime credits (deposits + refunds)

number
totalDebited

Lifetime debits (payments)

number
updatedAt
required

Last update timestamp

string format: date-time
Examples
Examplesuccess
{
  "success": true,
  "data": {
    "id": "cmwallet000001ny11aabbcc0",
    "customerId": "cmoabcde000001ny11aabbcc0",
    "balance": 1500,
    "currency": "USD",
    "totalCredited": 5000,
    "totalDebited": 3500,
    "updatedAt": "2026-05-12T08:00:00.000Z"
  }
}

401

Section titled “401”

Unauthorized — missing or invalid API key

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

403

Section titled “403”

Forbidden — route not in this key’s allowedRoutes

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

429

Section titled “429”

Rate limit exceeded

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying