Skip to content
Wink

Available balance

GET
/api/managing-entity/{managingEntityIdentifier}/payment/ledger/balance
 
curl --request GET \
  --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/ledger/balance \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns the withdrawable ledger balance per currency for the given managing entity. This is the authoritative source of truth for the withdrawal flow. Hotels are denominated in their local/source currency (e.g., THB); other beneficiaries in the internal currency (USD). Each balance entry shows the available amount ready for withdrawal.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Managing entity identifier (UUID)

Example 
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Available balance retrieved successfully

Media type application/json
Array<object>

Available withdrawable ledger balance for a single currency. Hotels are denominated in source currency (e.g., THB); affiliates and other beneficiaries in internal currency (USD).

object
amount
required

Available balance amount in the specified currency.

number
""
currencyCode
required

ISO 4217 currency code of the balance.

string
"" >= 1 characters
Example 
[
  null
]

400

Section titled “400 ”

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

401

Section titled “401 ”

Unauthorized — missing or invalid JWT token

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

403

Section titled “403 ”

Forbidden — missing ACCOUNTING:READ permission

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

404

Section titled “404 ”

Managing entity not found

Media type application/json
Array<object>

Available withdrawable ledger balance for a single currency. Hotels are denominated in source currency (e.g., THB); affiliates and other beneficiaries in internal currency (USD).

object
amount
required

Available balance amount in the specified currency.

number
""
currencyCode
required

ISO 4217 currency code of the balance.

string
"" >= 1 characters
Example 
[
  null
]

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}