GET/v1/hotels/book/:gdsprovider/:reference

Get hotel booking

Reads the current status of a hotel booking by provider and booking reference.

Endpoint

Method	Path	Auth
`GET`	`/v1/hotels/book/:gdsprovider/:reference`	Required API key

Required headers:

Header	Description
`Authorization`	`Bearer <secret_key>`. The secret is shown only once when the credential is created.
`X-Travelandz-Id`	`<public_key>:<profile_code>`. The `profile_code` is the `dp_`-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
`Content-Type`	Use `application/json` for requests with a body.

Request Params Schema

gdsprovider

numberYes

reference

stringYes

Request Body

No request body is required.

Success Response

Returns booking status

Response Body Schema

status

enum

confirmedcanceled

Yes

liveMode

booleanYes

True when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.

Example

bash

curl -X GET https://api.sandbox.travelandz.com/v1/hotels/book/:gdsprovider/:reference \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"