Skip to main content
Use this pageChatGPTClaudeCursor · OpenAPI · MCP

QuoteCriteria

Quote criteria (CriteriaQuoteInput proto)

optionRefIdstringrequired

Pass search options[].id here. After quote, book with optionQuote.optionRefId.

languagestring

Response language code (ISO 639-1)

Example: en
additionalData object

Optional string map forwarded to the integration. Aggregator also reads paymentMode (MERCHANT / DIRECT_ONLY) for VCC policy and skipMarkup.

property name*string
search_idstring

Analytics only (not a booking token). Funnel search ID from availability (searchId in JSON). Do not pass this value as optionRefId.

How it works:

  • Pass the search_id returned from /hotels/v1/availability to link this quote to the original search.
  • Enables funnel analysis: tracks conversion from Search → Quote.
  • If not provided, the system will attempt to link using:
    1. Request context (if same request flow)
    2. Correlation ID (as fallback for cross-request linking)
  • The source of the ID is tracked in analytics (search_id_source: "request", "context", "correlation_id").

Benefits:

  • Accurate funnel conversion metrics
  • Better analytics and reporting
  • Ability to track user journey across operations

Example: "search_id": "550e8400-e29b-41d4-a716-446655440000"

QuoteCriteria
{
  "optionRefId": "string",
  "language": "en",
  "additionalData": {
    "paymentMode": "MERCHANT"
  },
  "search_id": "string"
}