---
title: "Compare Dates"
method: POST
path: "/conv/agent-flight-searches/date-comparisons"
tags: ["conversational"]
---

# Compare Dates

`POST /conv/agent-flight-searches/date-comparisons`

## 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/agent-flight-searches/date-comparisons`
- Auth: none declared. Required headers: `X-Axel-Quote-Session`

Return ready exact prices; only our renderer may request background fills.

## Headers

- `X-Axel-Quote-Session` string, uuid, required
- `X-Axel-Flight-Source` string, nullable
- `X-Axel-Flight-Source-Signature` string, nullable

## Request body

- AgentFlightDateComparisonRequest
  - `request` AgentFlightQuoteRequest, required: Route search using existing airport resolution and traveler types.
    - `origin` string, required: Airport code, city/metro name or code, or comma-separated airport codes. Resolves to searchable airport codes before search.
    - `destination` string, required: Airport code, city/metro name or code, or comma-separated airport codes. Resolves to searchable airport codes before search.
    - `departure_date` string, date, required
    - `return_date` string, date, nullable
    - `passengers` AgentFlightPassengers, required: Anonymous pricing needs counts/types, never traveler identities.
      - `adults` integer, required
      - `children` integer
      - `infants_in_seat` integer
      - `infants_on_lap` integer
    - `airline` string, nullable
    - `max_stops` integer, nullable: Maximum stops per direction; null leaves stops unrestricted.
    - `cabin` 'economy' | 'business'
    - `currency` 'USD'
  - `dates` AgentFlightDatePair[], required
    - `departure_date` string, date, required
    - `return_date` string, date, nullable
  - `live` boolean
  - `intent` TravelIntent: Null means unknown, never unconstrained or consent. USD totals are for the party.
    - `willingness` 'definite' | 'price_dependent', nullable
    - `date_flexibility` 'fixed' | 'flexible', nullable
    - `fixed_commitment` boolean, nullable
    - `departure_windows` TravelDateWindow[]
      - `start` string, date, required
      - `end` string, date, required
    - `return_windows` TravelDateWindow[]
      - `start` string, date, required
      - `end` string, date, required
    - `departure_weekdays` integer[]: Allowed departure weekdays, Monday=0. Empty means unknown.
    - `return_weekdays` integer[]: Allowed return weekdays, Monday=0. Empty means unknown.
    - `stay_nights` integer, nullable
    - `stay_nights_min` integer, nullable
    - `stay_nights_max` integer, nullable
    - `origin_airport_codes` string[], nullable
    - `destination_airport_codes` string[], nullable
    - `depart_after` string, nullable: Earliest outbound departure, local clock time, inclusive.
    - `depart_before` string, nullable: Latest outbound departure, local clock time, inclusive. Before earlier than after denotes an overnight window.
    - `return_depart_after` string, nullable: Earliest return departure, local clock time, inclusive.
    - `return_depart_before` string, nullable: Latest return departure, local clock time, inclusive. Before earlier than after denotes an overnight window.
    - `arrive_by` string, date-time, nullable: Latest acceptable arrival at destination, destination local time. Buffer is subtracted from this deadline.
    - `return_by` string, date-time, nullable: Latest acceptable arrival home, origin local time. Buffer is subtracted from this deadline.
    - `arrival_buffer_minutes` integer, nullable
    - `return_buffer_minutes` integer, nullable
    - `airport_flexibility` 'exact' | 'nearby', nullable
    - `budget_target_cents` integer, nullable
    - `budget_limit_cents` integer, nullable
    - `currency` 'USD'
  - `wait_ms` integer

## Response `200`

Successful Response

- AgentFlightDateComparisonsResponse
  - `dates` AgentFlightDateComparison[], required
    - `departure_date` string, date, required
    - `return_date` string, date, nullable
    - `result` AgentFlightSearchOptionsResponse (unresolved $ref)
  - `background_status` 'active' | 'deferred': Deferred means missing prices are not being filled. Exact search and selected-offer links remain usable; do not repeatedly refresh the comparison.

## Other responses

- `422`: Validation Error

## Changes

> 68 revisions in range; 1 not diffed.

- **2026-10-18** `d5c0dc4b71d9`: 7 info
  - added the new optional request property `intent/anyOf[subschema #1: TravelIntent]/depart_after`
  - added the new optional request property `intent/anyOf[subschema #1: TravelIntent]/depart_before`
  - added the new optional request property `intent/anyOf[subschema #1: TravelIntent]/return_depart_after`
  - added the new optional request property `intent/anyOf[subschema #1: TravelIntent]/return_depart_before`
  - …3 more
- **2026-10-17** `7baf25d41b96`: 1 info
  - added the optional property `background_status` to the response with the `200` status
- **2026-10-16** `bffc187987a5`: 4 info
  - added the new optional request property `intent`
  - added the new optional request property `live`
  - added the new optional request property `wait_ms`
  - added the optional property `dates/items/result/anyOf[subschema #1: AgentFlightSearchOptionsResponse]/options/items/quality_sort_key` to the response with the `200` status
- **2026-10-16** `db594d8cf9a6`: 2 info
  - added the optional property `dates/items/result/anyOf[subschema #1: AgentFlightSearchOptionsResponse]/options/items/quality_flags` to the response with the `200` status
  - added the optional property `dates/items/result/anyOf[subschema #1: AgentFlightSearchOptionsResponse]/options/items/quality_rank` to the response with the `200` status
- **2026-10-15** `c14deb245ba3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/conv/agent-flight-searches/date-comparisons/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/8824999a7a0a?raw)