Skip to content

Sales overview

GET
/api/managing-entity/{managingEntityIdentifier}/extranet/booking/overview
curl --request GET \
--url https://api.wink.travel/api/managing-entity/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/extranet/booking/overview \
--header 'Authorization: Bearer <token>' \
--header 'Wink-Version: 2.0'

Returns grouped sales metrics summarising the property’s bookings for dashboard display.

managingEntityIdentifier
required
string
""

Show booking owned by this property

Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Grouped sales metrics for the property

Media typeapplication/json

Booking sales metrics grouped by a specific dimension (such as property or country), extending the base sales metrics with the group type, name, and identifier.

object
averageBookingAmount

Average booking value in the display currency.

number format: double
""
bookings

Total number of bookings in this metric set.

integer format: int64
""
currencyCode

Currency code for the monetary amounts.

string
"" /^[A-Z]{3}$/
totalPriceAmount

Total revenue from all bookings in the display currency.

number format: double
""
type

The dimension by which sales metrics are grouped.

string
""
Allowed values: BY_TOTAL BY_COUNTRY BY_PROPERTY
typeIdentifier

Unique identifier of the grouping entity.

string format: uuid
""
typeName

Display name of the grouping entity.

string
""
key
additional properties
""
Example
{
"averageBookingAmount": 4511.9,
"bookings": 42,
"currencyCode": "THB",
"totalPriceAmount": 189500,
"type": "BY_PROPERTY",
"typeIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
"typeName": "The Siam Residences, Bangkok"
}

Bad Request — missing or invalid request parameter or body

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Unauthorized — authentication is required or the session has expired

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Not Found — the requested resource does not exist

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Unsupported Media Type — use application/json

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example