> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Blue Pillow Hotels & Stays

> Blue Pillow provides AI agents with hotel and stay discovery, live offer comparison, recommendations, validation, and tracked booking handoff.

![Blue Pillow Hotels and Stays logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/bluepillow.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=dfe6e7b3ccf7c82396a60239a2be19f8)

* **Category:** ai agents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `BLUEPILLOW`
* **Version:** 00000000\_00

## Tools

> [accordion] Create Booking Handoff
>
> **Slug:** `BLUEPILLOW_CREATE_BOOKING_HANDOFF`
>
> Create only a tracked Blue Pillow handoff link for the user to continue the booking process. This does not reserve a room, confirm a reservation, or collect payment.
>
> #### Input Parameters
>
> **ota** `string`
>
> Preferred OTA from a current offer. Omit it to let Blue Pillow choose the best price.
>
> **dates** `object` *required*
>
> Stay dates to embed in the handoff link.
>
> **guests** `object` *required*
>
> Room occupancy to embed in the handoff link.
>
> **property\_id** `string` *required*
>
> Blue Pillow property ID the user chose.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Discover Destinations Near Coordinates
>
> **Slug:** `BLUEPILLOW_DISCOVER_DESTINATIONS_NEAR`
>
> Find cities, neighborhoods, airports, or points of interest near geographic coordinates.
>
> #### Input Parameters
>
> **language** `string ("en" | "it" | "fr" | "de" | "es" | "pt" | "nl" | "ko" | "pl" | "ja")`
>
> Language for destination names and display labels.
>
> **latitude** `number` *required*
>
> Latitude from -90 to 90.
>
> **longitude** `number` *required*
>
> Longitude from -180 to 180.
>
> **radius\_km** `number`
>
> Positive search radius in kilometers.
>
> **destination\_type** `string ("city" | "neighborhood" | "airport" | "poi")`
>
> Restrict candidates to one destination type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Property
>
> **Slug:** `BLUEPILLOW_GET_PROPERTY`
>
> Get canonical details and optional review enrichments for one property; use search or hotel recommendation for live availability.
>
> #### Input Parameters
>
> **include** `array`
>
> Review enrichments to include. reviews\_extended supersedes reviews\_sample; the list is sent as one comma-separated query value.
>
> **currency** `string`
>
> ISO 4217 pricing currency; defaults from user\_country and then to USD.
>
> **language** `string`
>
> Two-letter lowercase language code.
>
> **property\_id** `string` *required*
>
> Blue Pillow property ID returned by search or recommendation, normally prefixed prop\_.
>
> **user\_country** `string`
>
> ISO 3166 alpha-2 country for booking-link locale and default pricing currency.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Recommend Offer for Property
>
> **Slug:** `BLUEPILLOW_RECOMMEND_OFFER_FOR_PROPERTY`
>
> Compare live OTA offers and recommend the best offer for a property the user has already selected. This endpoint has no locale or currency input, so Blue Pillow applies provider defaults; use the currency returned in the response.
>
> #### Input Parameters
>
> **dates** `object` *required*
>
> Stay dates; check\_out must be after check\_in.
>
> **guests** `object` *required*
>
> Room occupancy for the stay.
>
> **property\_id** `string` *required*
>
> Selected Blue Pillow property ID returned by search or recommendation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Recommend Stay
>
> **Slug:** `BLUEPILLOW_RECOMMEND_STAY`
>
> Rank a location to one recommended stay plus alternatives. A recommendation may have no live price and unknown availability, so validate an offer before booking handoff.
>
> #### Input Parameters
>
> **dates** `object` *required*
>
> Stay dates; check\_out must be after check\_in.
>
> **guests** `object` *required*
>
> Room occupancy for the stay.
>
> **context** `object`
>
> Optional locale and agent context. When supplied, end\_user\_country and currency are both required.
>
> **location** `object` *required*
>
> Recommendation location. Destination IDs can come from Resolve Destination.
>
> **constraints** `object`
>
> Optional price, rating, property, amenity, cancellation, and OTA constraints.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resolve Destination
>
> **Slug:** `BLUEPILLOW_RESOLVE_DESTINATION`
>
> Resolve a place name into destination IDs for stay search, including ambiguity and confidence information.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Place name to resolve, such as a city, neighborhood, airport, or point of interest.
>
> **country** `string`
>
> Optional country bias used to disambiguate the place name.
>
> **language** `string ("en" | "it" | "fr" | "de" | "es" | "pt" | "nl" | "ko" | "pl" | "ja")`
>
> Language for destination names and display labels.
>
> **destination\_type** `string ("city" | "neighborhood" | "airport" | "poi")`
>
> Restrict candidates to a city, neighborhood, airport, or point of interest.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Stays
>
> **Slug:** `BLUEPILLOW_SEARCH_STAYS`
>
> Search one page of ranked live stay inventory with availability, prices, OTA offers, and an opaque cursor for more results.
>
> #### Input Parameters
>
> **sort** `string ("score_desc" | "price_asc" | "rating_desc" | "conversion_desc")`
>
> Ranking order for results.
>
> **dates** `object`
>
> Stay dates, required for an initial search and omitted for a cursor-only continuation; check\_out must be after check\_in.
>
> **limit** `integer`
>
> Maximum results in this page, from 1 to 100.
>
> **guests** `object`
>
> Room occupancy, required for an initial search and omitted for a cursor-only continuation.
>
> **filters** `object`
>
> Optional result filters.
>
> **currency** `string`
>
> Uppercase ISO 4217 currency for returned prices.
>
> **language** `string`
>
> Two-letter lowercase response language code.
>
> **location** `object`
>
> Search location, required for an initial search and omitted for a cursor-only continuation. Prefer a destination\_id returned by Resolve Destination.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call. It restores the original search criteria, so continuation may provide this field alone.
>
> **user\_country** `string`
>
> Uppercase ISO 3166 alpha-2 country for locale and default currency.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate Offer
>
> **Slug:** `BLUEPILLOW_VALIDATE_OFFER`
>
> Re-price a previously seen EUR offer and report whether it remains valid within the provider's two-percent tolerance.
>
> #### Input Parameters
>
> **dates** `object` *required*
>
> Exact stay dates associated with the observed offer.
>
> **guests** `object` *required*
>
> Exact room occupancy associated with the observed offer.
>
> **property\_id** `string` *required*
>
> Blue Pillow property ID for the observed offer.
>
> **offer\_to\_compare** `object` *required*
>
> Previously observed offer expressed in EUR. A numeric amount from another currency must be converted to EUR before comparison.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
