List bookings

GET

/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/booking/list

const url = 'https://integrations.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/channel-manager/property/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/booking/list?startDate=2026-02-01T10%3A30%3A00&endDate=2026-02-02T10%3A30%3A00';
const options = {
  method: 'GET',
  headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://integrations.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/channel-manager/property/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/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

oauth2ClientCredentials

Parameters

Path Parameters

managingEntityIdentifier

required

string

Rate provider (channel-manager account) identifier (UUID)

Example

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

propertyIdentifier

required

string

Property identifier (UUID)

Example

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

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

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Responses

200

All bookings for the given property in the requested creation date range

application/json

Array<object>

A single booking for a property: guest details, payment status, the net sales total, and one room-stay entry per booked room

object

bookingIdentifier

required

Booking ID

string format: uuid

"" >= 1 characters

propertyIdentifier

required

Property ID

string format: uuid

"" >= 1 characters

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

totalAmount

required

Net sales total in supplier currency — the amount the hotel receives for the entire booking (all rooms)

number

currencyCode

required

Supplier currency code

string

"" >= 1 characters

bookingCode

required

User-friendly booking confirmation code

string

"" >= 1 characters

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

Booking lifecycle status. INITIALIZED: awaiting payment; TEST_PAYMENT_SUCCEEDED: test booking; PAYMENT_SUCCEEDED: payment confirmed; PAYMENT_FAILED: payment declined; FAILED: system failure post-payment; CANCELLED: cancelled by any party; PARTIALLY_REFUNDED: partial refund issued; FULLY_REFUNDED: full refund issued

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

roomStays

required

Per-room stay detail — one entry per physical room booked

Array<object>

"" >= 1 items

A single physical room within a booking, including its rate, occupancy, stay dates, and per-room net sales amount

object

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

adults

required

Number of adults in this room

integer format: int32

children

required

Number of children in this room

integer format: int32

guests

required

Total number of guests in this room (adults and children)

integer format: int32

startDate

required

Room check-in date (arrival)

string format: date

endDate

required

Room check-out date (departure)

string format: date

amount

required

Net sales amount for this room in supplier currency (the booking’s net sales total divided across its rooms)

number

Example

[
  {
    "bookingIdentifier": "f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92",
    "propertyIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18",
    "firstName": "Alexandra",
    "lastName": "Beaumont",
    "email": "[email protected]",
    "totalAmount": "450.00",
    "currencyCode": "THB",
    "bookingCode": "WNK4ZQ7P",
    "createdDate": "2026-02-01T10:30:00",
    "cancelled": false,
    "paymentMethodType": "Card",
    "paymentMethodStatus": "SUCCEEDED",
    "salesChannelName": "Wink Travel Agents",
    "salesChannelIdentifier": "7a0c5d9e-2f6b-4c1a-8e4d-3b9f1a0c6d52",
    "roomStays": [
      {
        "roomRateIdentifier": "5e8a3b7c-0d4f-4a2b-8c1d-9e6f2a0b4c73",
        "name": "Superior Deluxe - BAR",
        "guestRoomName": "Superior Deluxe",
        "ratePlanName": "BAR",
        "adults": 2,
        "children": 1,
        "guests": 3,
        "startDate": "2026-02-15",
        "endDate": "2026-02-17",
        "amount": "450.00"
      }
    ]
  }
]

400

Bad Request — missing or invalid request parameter or body

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

401

Unauthorized — authentication is required or the session has expired

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

403

Forbidden — authenticated but lacking the required permission or scope

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

404

Not Found — the requested resource does not exist

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

405

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

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

415

Unsupported Media Type — use application/json

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

500

Internal Server Error — an unexpected failure occurred on the server

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

503

Service Unavailable — a downstream dependency is unreachable

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties