Hotel offer list — Skyscanner

skyscanner.hotel.offer.list

Compare hotel room offers and provider booking links

POST /v1/operations/skyscanner.hotel.offer.list

Headers

Authorization: Bearer YOUR_CONNECTOR_TOKEN
x-connection-ref: YOUR_CONNECTION_REF
Content-Type: application/json

Inputs

Parameter	Example type	Example value
hotel_entity_id	string	"46945771"
checkin_date	string	"2026-11-03"
checkout_date	string	"2026-11-05"

Example input

{
  "hotel_entity_id": "46945771",
  "checkin_date": "2026-11-03",
  "checkout_date": "2026-11-05"
}

Illustrative response for the example input. Availability, prices and result order vary. Replace example references and URLs with values returned by your own requests.

Example response

{
  "hotel_entity_id": "46945771",
  "currency": "GBP",
  "booking_status": "available",
  "items": [
    {
      "provider": "Example travel provider",
      "room_name": "Double room",
      "price_total_minor": 24000,
      "price_per_night_minor": 12000,
      "features": [
        "Free cancellation"
      ],
      "booking_url": "https://example.com/hotel-booking"
    }
  ]
}

Open JSON schema

Input schema

{
  "$id": "https://useajar.com/schemas/skyscanner/hotel-offer-list.input.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "adults": {
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "checkin_date": {
      "format": "date",
      "type": "string"
    },
    "checkout_date": {
      "format": "date",
      "type": "string"
    },
    "child_ages": {
      "items": {
        "maximum": 17,
        "minimum": 0,
        "type": "integer"
      },
      "maxItems": 12,
      "type": "array"
    },
    "currency": {
      "description": "Preferred price currency; defaults to GBP.",
      "enum": [
        "GBP",
        "EUR",
        "USD"
      ]
    },
    "hotel_entity_id": {
      "pattern": "^[0-9]{1,20}$",
      "type": "string"
    },
    "limit": {
      "maximum": 30,
      "minimum": 1,
      "type": "integer"
    },
    "rooms": {
      "maximum": 10,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "hotel_entity_id",
    "checkin_date",
    "checkout_date"
  ],
  "title": "Skyscanner hotel-search input",
  "type": "object"
}