Skip to content

List saved charts

GET
/api/chart/list
curl --request GET \
--url https://api.wink.travel/api/chart/list \
--header 'Authorization: Bearer <token>' \
--header 'Wink-Version: 2.0'

Returns a list of all analytics charts saved by the authenticated user, sorted by sort priority.

Wink-Version
string
default: 2.0.0
Allowed values: 2.0

OK

Media type application/json
Array<object>
object
id

Document UUID

string format: uuid
""
createdDate

Datetime this record was first created

string format: date-time
""
lastUpdate

Datetime this record was last updated

string format: date-time
""
version

Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.

integer format: int64
""
ownerIdentifier
required

Owner of this chart

string format: uuid
"" >= 1 characters
name
required

Chart name as named by creator

string
"" >= 1 characters
sort

Sort a list of charts by this sort value.

integer format: int32
default: -1
details
required

Chart settings

object
series
required

Time series granularity for data aggregation

string
""
Allowed values: HOUR DAY MONTH YEAR
timeSeriesUnits

Number of time-series units to visualize (e.g., last 12 months). Required if startDate and endDate are not provided.

integer format: int64
""
startDate

Inclusive start of the analysis period. Required if timeSeriesUnits is not provided.

string format: date-time
""
endDate

Inclusive end of the analysis period. Required if timeSeriesUnits is not provided.

string format: date-time
""
filterOnHotelIdentifier

Filter analytics to a single property by identifier and name

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnChannelSubType

Filter by affiliate channel type (e.g., direct booking engine, OTA, travel agent)

string
""
Allowed values: TRIP_PAY FACILITATOR DIRECT APPLICATION HOTEL TRAVELIKO CORPORATE TRAVEL_AGENT INFLUENCER BLOGGER DESTINATION CHANNEL_MANAGER PROPERTY_MANAGEMENT_SYSTEM CENTRAL_RESERVATION_SYSTEM GOOGLE_HOTEL_API MANAGEMENT_COMPANY CHAIN BRAND EVENT_ORGANIZER OTHER
filterOnOwnerIdentifier

Filter by affiliate/seller identifier and name

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnEngineCountryGeoNameId

Filter by the customization’s origin country (GeoName ID and name)

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnEngineCityGeoNameId

Filter by the customization’s origin city (GeoName ID and name)

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnEngineContinentCode

Filter by the customization’s origin continent

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnEngineConfigurationIdentifier

Filter by a specific customization/booking engine (identifier and name)

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnCountryGeoNameId

Filter by booker’s country of origin (GeoName ID and name)

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnCityGeoNameId

Filter by booker’s city of origin (GeoName ID and name)

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnContinentCode

Filter by booker’s continent of origin

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
filterOnUserIdentifier

Filter to a specific authenticated booker by user identifier

object
value
required

The value that should be persisted.

string
"" >= 1 characters
label
required

English readable text of the value.

string
"" >= 1 characters
includePageVisits

Include property page view count in results

boolean
includeMapMarkerVisits

Include map marker interaction count in results

boolean
includeCardVisits

Include property card interaction count in results

boolean
includeBookings

Include booking count metric in results

boolean
includeCancellations

Include cancellation count metric in results

boolean
includeRoomNights

Include total room nights booked in results

boolean
includeMeetingRooms

Include meeting room booking count in results

boolean
includeMeetingRoomsRevenue

Include meeting room revenue in results

boolean
includeRestaurants

Include restaurant booking count in results

boolean
includeRestaurantsRevenue

Include restaurant revenue in results

boolean
includeSpas

Include spa booking count in results

boolean
includeSpasRevenue

Include spa revenue in results

boolean
includeActivities

Include activity booking count in results

boolean
includeActivitiesRevenue

Include activity revenue in results

boolean
includeAttractions

Include attraction booking count in results

boolean
includeAttractionsRevenue

Include attraction revenue in results

boolean
includePlaces

Include place booking count in results

boolean
includePlacesRevenue

Include place revenue in results

boolean
includeRoomTypeAncillaries

Include room package count in results

boolean
includeRoomTypeAncillariesRevenue

Include room package revenue in results

boolean
includeAddOns

Include add-on item count in results

boolean
includeAddOnsRevenue

Include add-on revenue in results

boolean
includeTotalRoomRevenue

Include total room/lodging revenue in results

boolean
includeAverageRoomRate

Include average room rate (revenue per room night) in results

boolean
includeTotalAncillariesRevenue

Include combined ancillary revenue (packages and add-ons) in results

boolean
includeTotalNetRevenue

Include total net revenue (room + ancillaries after commissions) in results

boolean
includeCancelledRoomNights

Include cancelled room night count in results

boolean
includeCancelledMeetingRooms

Include cancelled meeting room count in results

boolean
includeCancelledMeetingRoomsRevenue

Include cancelled meeting room revenue in results

boolean
includeCancelledRestaurants

Include cancelled restaurant count in results

boolean
includeCancelledRestaurantsRevenue

Include cancelled restaurant revenue in results

boolean
includeCancelledSpas

Include cancelled spa count in results

boolean
includeCancelledSpasRevenue

Include cancelled spa revenue in results

boolean
includeCancelledActivities

Include cancelled activity count in results

boolean
includeCancelledActivitiesRevenue

Include cancelled activity revenue in results

boolean
includeCancelledAttractions

Include cancelled attraction count in results

boolean
includeCancelledAttractionsRevenue

Include cancelled attraction revenue in results

boolean
includeCancelledPlaces

Include cancelled place count in results

boolean
includeCancelledPlacesRevenue

Include cancelled place revenue in results

boolean
includeCancelledRoomTypeAncillaries

Include cancelled package count in results

boolean
includeCancelledRoomTypeAncillariesRevenue

Include cancelled package revenue in results

boolean
includeCancelledAddOns

Include cancelled add-on count in results

boolean
includeCancelledAddOnsRevenue

Include cancelled add-on revenue in results

boolean
includeCancelledTotalRoomRevenue

Include cancelled lodging revenue in results

boolean
includeCancelledTotalAncillariesRevenue

Include combined cancelled ancillary revenue in results

boolean
includeCancelledTotalNetRevenue

Include total cancelled net revenue in results

boolean
groupOnChannelSubType

Group results by affiliate channel type (e.g., direct vs. OTA)

boolean
groupOnOwnerIdentifier

Group results by affiliate/seller

boolean
groupOnEngineCountryGeoNameId

Group results by customization’s origin country

boolean
groupOnEngineCityGeoNameId

Group results by customization’s origin city

boolean
groupOnEngineContinentCode

Group results by customization’s origin continent

boolean
groupOnEngineConfigurationIdentifier

Group results by specific customization/booking engine

boolean
groupOnCountryGeoNameId

Group results by booker’s country of origin

boolean
groupOnCityGeoNameId

Group results by booker’s city of origin

boolean
groupOnContinentCode

Group results by booker’s continent of origin

boolean
groupOnHotelIdentifier

Group results by property

boolean
groupOnUserIdentifier

Group results by individual booker

boolean
currencyCode

Currency code for revenue display (e.g., USD, EUR, GBP, THB)

string
default: USD
Example
[
{
"id": "",
"createdDate": "",
"lastUpdate": "",
"version": "",
"ownerIdentifier": "",
"name": "",
"sort": -1,
"details": ""
}
]

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

Unauthorized

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

Forbidden

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

Internal Server Error

object
Example generated
{}