---
title: "Warm Entry Search"
method: POST
path: "/conv/entry-search/warm"
tags: ["conversational"]
---

# Warm Entry Search

`POST /conv/entry-search/warm`

## Request

- Base URL: `https://api.helloaxel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helloaxel.com/conv/entry-search/warm`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/helloaxel/apis/client-api-gateway/docs/conv/entry-search/warm/post.ts> (a function with typed inputs; its response is checked against the schema)

Start the supplier fetch for a dates entry before the trip exists.

Best effort, never an error to the form: a person over the cap, or a
brain that cannot be reached, gets ``started: false`` and their search
fetches when the trip is created, as before. Each call can cost one
supplier search, hence the per-person cap; the content cache dedupes
identical searches within it.

## Request body

- EntrySearchWarmRequest: A dates entry the person is still composing (lib/guest/entry flightDatesEntryFacts).
  - `flight_search` TripFlightSearch, required: Complete entry criteria for the existing search_flights tool.
    - `origin` string, required
    - `destination` string, required
    - `depart_date` string, date, required
    - `return_date` string, date, nullable
    - `passenger_mix` PassengerCount: Passenger breakdown for offers/searches. Simple counts by type.
      - `adults` integer
      - `children` integer
      - `infants_in_seat` integer
      - `infants_on_lap` integer
    - `cabin_class` 'economy' | 'premium_economy' | 'business' | 'first'
    - `nonstop` boolean
    - `airlines` string
    - `exclude_airlines` string
    - `include_redeye` boolean
    - `max_stops` integer, nullable
    - `depart_after` string
    - `depart_before` string

## Response `200`

Successful Response

- EntrySearchWarmResponse
  - `started` boolean, required

## Other responses

- `422`: Validation Error

## Changes

> 120 revisions in range; 1 not diffed.

- **2026-11-04** `7fd27d93bec0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/conv/entry-search/warm/post.md)

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) - [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/helloaxel/apis/client-api-gateway/revisions/a11c765e10e5?raw)