Skip to main content
GET
Get a hotel search item
Open a hotel of the search results to see what the list only summarizes: the full hotel record and the roomGroups available for the requested occupancy, each with its rooms and rates. To book it, create a trip with the item’s id as searchItemId and each chosen room’s id as roomId. Amounts are integers in cents: 98700 is R$ 987,00. The item lives as long as its search (see ttl). An error the travel provider reports about the request is returned with its own status, code and message.

Path Parameters

realmId
string<uuid>
required

ID of your realm.

Format: UUID

organizationId
string<uuid>
required

ID of your organization.

Format: UUID

searchId
string
required

ID of the search, as returned when it was created.

Pattern: ^srch_[0-9A-Za-z]{21}$
itemId
string
required

ID of the item to load, as listed in the items of the search results.

Pattern: ^srch_item_[0-9A-Za-z]{21}$

Response

Successful response

The detail of one hotel of a hotel search: the full hotel record and its room combinations.

id
string
required

ID of the item. Send it as searchItemId when you create a trip.

Example:

"srch_item_Zt5Hk2NwQe8Lr3VcXb1Ya"

searchId
string
required

ID of the search the item belongs to.

Example:

"srch_Qm8Zt3LwXc1Ry7NvB0kHd"

hotel
object
required

The full record of the hotel.

checkIn
string
required

Check-in date (YYYY-MM-DD).

Example:

"2026-11-02"

checkOut
string
required

Check-out date (YYYY-MM-DD).

Example:

"2026-11-05"

roomGroups
object[]
required

The room combinations available for the requested occupancy, each with its rooms and rates — send a room's id as roomId when you create a trip.