Hotel details

One hotel's catalogue facts: names, address, location, time zone, check-in and check-out times, the full description, every policy and the amenities, and its rooms with include: "rooms".

The full rules agents follow for this call are on its MCP tool's page, get_hotel.

GET

/v1/hotels/{hotelId}

Authorization

bearerAuth

headerAuthorizationBearer <token>

A Fortrip OAuth access token from the device authorization flow (RFC 8628). GET /v1/auth/config returns the flow's endpoints.

Path Parameters

hotelId*string

hotelId from a search response.

Match^htl_[0-9A-Za-z]{20}$

Query Parameters

include?"rooms"

rooms adds the room list.

Value in"rooms"

locale?string

Language for names and text in the response: en or zh.

Value in"en""zh"

Response Body

Hotel details

application/json

response

hotelId*string

Match^htl_[0-9A-Za-z]{20}$

name*string

names*

bookable*boolean

stars*number|null

address*

location*|null

timeZone*string|null

description*|null

photos*array<>|

Up to 8 hotel photos, the cover first; null when the catalogue lists none.

checkInTimes*

checkOutTimes*

policies*

amenities*

breakfastServed*boolean|null

deposit*

contact*

rooms?

[key: string]?unknown

Example Request

curl -X GET 'https://api.fortrip.ai/v1/hotels/string'

Example Request

curl -X GET 'https://api.fortrip.ai/v1/hotels/string'

Example ResponseSchema

{
  "hotelId": "string",
  "name": "string",
  "names": {
    "en": "string",
    "zh": "string",
    "property1": null,
    "property2": null
  },
  "bookable": true,
  "stars": 0,
  "address": {
    "line": {
      "text": "string",
      "locale": "en",
      "property1": null,
      "property2": null
    },
    "countryCode": "string",
    "region": {
      "placeId": "string",
      "name": "string",
      "names": {
        "en": "string",
        "zh": "string",
        "property1": null,
        "property2": null
      },
      "property1": null,
      "property2": null
    },
    "property1": null,
    "property2": null
  },
  "location": {
    "lat": 0,
    "lng": 0,
    "property1": null,
    "property2": null
  },
  "timeZone": "string",
  "description": {
    "text": "string",
    "locale": "en",
    "property1": null,
    "property2": null
  },
  "photos": [
    {
      "url": "string",
      "caption": {
        "text": "string",
        "locale": "en",
        "property1": null,
        "property2": null
      },
      "property1": null,
      "property2": null
    }
  ],
  "checkInTimes": {
    "from": "string",
    "until": "string",
    "property1": null,
    "property2": null
  },
  "checkOutTimes": {
    "from": "string",
    "until": "string",
    "property1": null,
    "property2": null
  },
  "policies": {
    "listed": true,
    "items": [
      {
        "topic": "check_in",
        "text": "string",
        "locale": "en",
        "property1": null,
        "property2": null
      }
    ],
    "property1": null,
    "property2": null
  },
  "amenities": {
    "listed": true,
    "items": [
      {
        "code": "parking",
        "name": {
          "text": "string",
          "locale": "en",
          "property1": null,
          "property2": null
        },
        "property1": null,
        "property2": null
      }
    ],
    "property1": null,
    "property2": null
  },
  "breakfastServed": true,
  "deposit": {
    "required": true,
    "amount": {
      "amount": "string",
      "currency": "string",
      "property1": null,
      "property2": null
    },
    "property1": null,
    "property2": null
  },
  "contact": {
    "phone": "string",
    "website": "string",
    "property1": null,
    "property2": null
  },
  "rooms": {
    "listed": true,
    "items": [
      {
        "name": {
          "text": "string",
          "locale": "en",
          "property1": null,
          "property2": null
        },
        "beds": {
          "text": "string",
          "locale": "en",
          "property1": null,
          "property2": null
        },
        "areaSqm": {
          "min": 0,
          "max": 0,
          "property1": null,
          "property2": null
        },
        "maxOccupancy": -9007199254740991,
        "window": "yes",
        "property1": null,
        "property2": null
      }
    ],
    "property1": null,
    "property2": null
  },
  "property1": null,
  "property2": null
}

{  "hotelId": "string",  "name": "string",  "names": {    "en": "string",    "zh": "string",    "property1": null,    "property2": null  },  "bookable": true,  "stars": 0,  "address": {    "line": {      "text": "string",      "locale": "en",      "property1": null,      "property2": null    },    "countryCode": "string",    "region": {      "placeId": "string",      "name": "string",      "names": {        "en": "string",        "zh": "string",        "property1": null,        "property2": null      },      "property1": null,      "property2": null    },    "property1": null,    "property2": null  },  "location": {    "lat": 0,    "lng": 0,    "property1": null,    "property2": null  },  "timeZone": "string",  "description": {    "text": "string",    "locale": "en",    "property1": null,    "property2": null  },  "photos": [    {      "url": "string",      "caption": {        "text": "string",        "locale": "en",        "property1": null,        "property2": null      },      "property1": null,      "property2": null    }  ],  "checkInTimes": {    "from": "string",    "until": "string",    "property1": null,    "property2": null  },  "checkOutTimes": {    "from": "string",    "until": "string",    "property1": null,    "property2": null  },  "policies": {    "listed": true,    "items": [      {        "topic": "check_in",        "text": "string",        "locale": "en",        "property1": null,        "property2": null      }    ],    "property1": null,    "property2": null  },  "amenities": {    "listed": true,    "items": [      {        "code": "parking",        "name": {          "text": "string",          "locale": "en",          "property1": null,          "property2": null        },        "property1": null,        "property2": null      }    ],    "property1": null,    "property2": null  },  "breakfastServed": true,  "deposit": {    "required": true,    "amount": {      "amount": "string",      "currency": "string",      "property1": null,      "property2": null    },    "property1": null,    "property2": null  },  "contact": {    "phone": "string",    "website": "string",    "property1": null,    "property2": null  },  "rooms": {    "listed": true,    "items": [      {        "name": {          "text": "string",          "locale": "en",          "property1": null,          "property2": null        },        "beds": {          "text": "string",          "locale": "en",          "property1": null,          "property2": null        },        "areaSqm": {          "min": 0,          "max": 0,          "property1": null,          "property2": null        },        "maxOccupancy": -9007199254740991,        "window": "yes",        "property1": null,        "property2": null      }    ],    "property1": null,    "property2": null  },  "property1": null,  "property2": null}

Hotel details

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Query ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Query Parameters

Response Body