Skip to content
Wink

List bookings

GET
/api/managing-entity/{managingEntityIdentifier}/channel-manager/booking/list
 
curl --request GET \
  --url 'https://integrations.wink.travel/api/managing-entity/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/channel-manager/booking/list?startDate=2026-02-01T10%3A30%3A00&endDate=2026-02-02T10%3A30%3A00' \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns all bookings created for the given property between startDate and endDate; when endDate is omitted it defaults to startDate plus one day.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Property identifier (UUID)

Example 
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18

Query Parameters

Section titled “Query Parameters ”
startDate
required
string
""

Start timestamp for booking creation date filter (inclusive); if endDate is omitted, it defaults to startDate + 1 day

Example 
2026-02-01T10:30:00
endDate
string
""

End timestamp for booking creation date filter (inclusive; optional; defaults to startDate + 1 day)

Example 
2026-02-02T10:30:00

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 ”

OK

Media type application/json
Array<object>
object
bookingIdentifier
required

Booking ID

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

Property ID

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

Master Rate ID

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

Master Rate name

string
"" >= 1 characters
guestRoomName
required

Guest room name

string
"" >= 1 characters
ratePlanName
required

Rate plan name

string
"" >= 1 characters
rooms
required

Number of rooms in booking

integer format: int32
""
guests
required

Total number of guests (adults and children)

integer format: int32
""
adults
required

Number of adults in booking

integer format: int32
""
children
required

Number of children in booking

integer format: int32
""
firstName
required

First name of primary guest

string
"" >= 1 characters
lastName
required

Last name of primary guest

string
"" >= 1 characters
email
required

Email address of primary guest

string
"" >= 1 characters
amount
required

Total booking amount in supplier currency

number
""
currencyCode
required

Supplier currency code

string
"" >= 1 characters
bookingCode
required

User-friendly booking confirmation code

string
"" >= 1 characters
startDate
required

Room check-in date (arrival)

string format: date
""
endDate
required

Room check-out date (departure)

string format: date
""
createdDate
required

Timestamp when booking was created

string format: date-time
""
cancelled
required

Whether the booking is cancelled

boolean
cancelDate

Timestamp when booking was cancelled (null if not cancelled)

string format: date-time
""
paymentMethodType
required

Payment method type (e.g. Card, Direct Debit)

string
"" >= 1 characters
paymentWalletType

Payment wallet provider if applicable (e.g. Google Pay, Apple Pay)

string
""
paymentMethodStatus
required

Payment transaction status

string
""
Allowed values: INITIALIZED TEST_PAYMENT_SUCCEEDED PAYMENT_SUCCEEDED PAYMENT_FAILED FAILED CANCELLED PARTIALLY_REFUNDED FULLY_REFUNDED
salesChannelName
required

Sales channel name (bookable inventory source)

string
"" >= 1 characters
salesChannelIdentifier
required

Sales channel ID

string format: uuid
"" >= 1 characters
Example 
[
  {
    "bookingIdentifier": "",
    "propertyIdentifier": "",
    "roomRateIdentifier": "",
    "name": "",
    "guestRoomName": "",
    "ratePlanName": "",
    "rooms": "",
    "guests": "",
    "adults": "",
    "children": "",
    "firstName": "",
    "lastName": "",
    "email": "",
    "amount": "",
    "currencyCode": "",
    "bookingCode": "",
    "startDate": "",
    "endDate": "",
    "createdDate": "",
    "cancelled": false,
    "cancelDate": "",
    "paymentMethodType": "",
    "paymentWalletType": "",
    "paymentMethodStatus": "INITIALIZED",
    "salesChannelName": "",
    "salesChannelIdentifier": ""
  }
]

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

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

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

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}