lastminute.com headline price API reference

The stay for one room as lastminute.com's deal card shows it ("Total price for 2 nights"), in GBP, with the crossed-out price, free cancellation, pay later and breakfast or room only. There is no room list, and no tax is itemised. A hotel lastminute.com marks sold out answers availability: sold_out; dates about a year out and past dates are a 422; a hotel id with no page, or not listed for the stay, is a 404.

Request

POSThttps://api.scrapercompany.com/v1/ota/lastminute

Authenticate with your API key in the x-api-key header (see Authentication).

Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.

Body

JSON object. Unknown fields are rejected with 422.

hotelstringrequiredmin length 1, max length 2048
lastminute.com hotel id, or its page URL (.../one-aldwych_hid-134218).
destinationstring | nullpattern ^[A-Z]{3}-\d{1,12}$
The hotel's city code (TOR-5370 is London). Omit it and it is read from the hotel's page.
check_instring (date)required
First night of the stay, YYYY-MM-DD.
check_outstring (date) | null
Departure date. An alternative to nights — if both are given, this wins.
nightsintegerdefault 1min 1, max 30
Length of stay. Ignored when check_out is supplied.
adultsintegerdefault 2min 1, max 6
Adults in the one room quoted.

Example request

curl -X POST "https://api.scrapercompany.com/v1/ota/lastminute" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hotel": "134218",
    "check_in": "2026-12-25"
  }'

Response

200 — lastminute.com headline price for one stay (GBP). Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

200 response

{
  "search_parameters": {
    "engine": "lastminute_property",
    "hotel_id": "134218",
    "destination": "TOR-5370",
    "check_in_date": "2027-03-08",
    "check_out_date": "2027-03-10",
    "nights": 2,
    "adults": 2
  },
  "property": {
    "property_id": "134218",
    "name": "One Aldwych",
    "city": "London",
    "country_code": "GB",
    "stars": 5,
    "url": "https://www.lastminute.com/hotels/united-kingdom/london/one-aldwych_hid-134218",
    "destination": "TOR-5370",
    "price_per_night": 930.87,
    "total": 1861.74,
    "strikethrough_total": 1861.74,
    "currency": "GBP",
    "free_cancellation": false,
    "pay_later": false,
    "sold_out": false,
    "rate_category": "unknown",
    "meal_plan": "room_only",
    "availability": "available",
    "is_soldout": false,
    "provenance": {
      "schema_version": 1,
      "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
      "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
      "observed_at": "2026-08-07T01:23:45.678Z",
      "source": "lastminute",
      "source_kind": "ota_search_listing",
      "source_property_id": "134218",
      "requested_market": "GB",
      "requested_currency": "GBP",
      "returned_currency": "GBP",
      "price_basis": "stay_total_as_shown",
      "derivation": "normalized_upstream"
    }
  },
  "meta": {
    "source": "lastminute",
    "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
    "observed_at": "2026-08-07T01:23:45.678Z",
    "nights": 2,
    "adults": 2,
    "polls": 1,
    "elapsed_s": 3.5,
    "notes": "One headline price: the stay for one room as lastminute.com's deal card shows it, in GBP. No tax is itemised, so none is claimed; there is no room list."
  }
}

Response fields

Fields marked required are always present; others appear when they apply.

search_parametersobjectrequired
Show 7 child fieldsHide child fields
- search_parameters.enginestringrequired
  One oflastminute_property
- search_parameters.hotel_idstringrequired
- search_parameters.destinationstringrequired
  The hotel's city code, e.g. TOR-5370.
- search_parameters.check_in_datestring (date)required
- search_parameters.check_out_datestring (date)required
- search_parameters.nightsintegerrequired
- search_parameters.adultsintegerrequired
propertyobjectrequired
Show 25 child fieldsHide child fields
- property.property_idstringrequired
  The lastminute.com hotel id.
- property.namestring | nullrequired
- property.citystring | nullrequired
- property.country_codestring | nullrequired
- property.starsinteger | nullrequired
- property.urlstring | nullrequired
- property.destinationstringrequired
- property.price_per_nightnumber | nullrequired
  total divided by the nights.
- property.totalnumber | nullrequired
  The stay for one room as the deal card shows it; null when sold out.
- property.strikethrough_totalnumber | nullrequired
  The crossed-out price.
- property.currencystringrequired
  One ofGBP
- property.free_cancellationbooleanrequired
- property.pay_laterbooleanrequired
- property.sold_outbooleanrequired
- property.rate_codestring | nullrequired
- property.rate_categorystringrequired
- property.rate_category_sourcestring | nullrequired
- property.refundableboolean | nullrequired
- property.meal_planstring | nullrequired
- property.rate_code_scopestring | nullrequired
- property.availabilitystringrequired
  One ofavailablesold_out
- property.is_soldoutboolean | nullrequired
- property.availability_reasonstring | nullrequired
- property.min_length_of_stayinteger | nullrequired
- property.provenanceobject | nullrequired
  Provenance of the cheapest priced row; null when nothing priced.
  Show 13 child fieldsHide child fields
  - property.provenance.schema_versionintegerrequired
    Provenance schema version (currently 1).
  - property.provenance.observation_idstringrequired
    Deterministic id of this price observation (rateobs_...).
  - property.provenance.collection_idstringrequired
    Id shared by every price from one upstream fetch (ratecol_...).
  - property.provenance.observed_atstringrequired
    UTC observation time, ISO-8601.
  - property.provenance.sourcestringrequired
    Upstream source, e.g. google_hotels_calendar.
  - property.provenance.source_kindstringrequired
    Kind of source, e.g. calendar, offer, ota_calendar, official.
  - property.provenance.source_property_idstringrequired
    Property identifier at the source.
  - property.provenance.requested_marketstring | nullrequired
  - property.provenance.requested_currencystring | nullrequired
  - property.provenance.returned_currencystring | nullrequired
  - property.provenance.price_basisstringrequired
    What the price represents, e.g. room_base_before_taxes_and_fees.
  - property.provenance.derivationstringrequired
    How the figure was derived, e.g. normalized_upstream.
  - property.provenance.upstream_rate_idstring | nullrequired
    Source-native rate/room id when available.
metaobjectrequired
Show 8 child fieldsHide child fields
- meta.sourcestringrequired
  One oflastminute
- meta.collection_idstringrequired
- meta.observed_atstringrequired
- meta.nightsintegerrequired
- meta.adultsintegerrequired
- meta.pollsintegerrequired
- meta.elapsed_snumberrequired
- meta.notesstringrequired

Errors

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

Status	Meaning	Retry?
`401`Unauthorized	Missing or invalid API key. `{"detail":"missing or invalid API key"}`	No, fix the request
`402`Payment Required	Not enough credits for this request: the account's credits mode is `enforce` (`mode` in `GET /v1/billing`) and the request costs more than the available credits. Nothing is run or charged. `{"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."}`	No, fix the request
`404`Not Found	The property, stay, job or record was not found. `{"detail":"job not found"}`	No, fix the request
`422`Unprocessable Content	Request validation failed. `detail` is a list of problems for schema errors, or a string for semantic checks performed by the endpoint. `{"detail":[{"loc":["body","name"],"msg":"Field required","type":"missing"}]}`	No, fix the request
`429`Too Many Requests	Too many requests: the key's requests-per-minute limit was exceeded, or (in `enforce` credits mode) the plan's concurrent-request limit. No rate-limit or Retry-After headers are sent; back off and retry. `{"detail":"rate limit 60/min exceeded"}`	Yes, with backoff
`503`Service Unavailable	Temporarily unavailable: a dependency of this endpoint is down, or the upstream source changed its contract. Retry later. `{"detail":"database unavailable: OperationalError"}`	Yes, with backoff

Try it

Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.

Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? start a free trial).
Copy the cURL example above and run it in a terminal.

Credits

12 credits per successful call. Failed, blocked and empty results are free.

Request#

Body#

Example request#

Response#

Response fields#

Errors#

Try it#