---
title: "Search Cheapest Dates"
method: POST
path: "/api/fares/cheapest-dates"
---

# Search Cheapest Dates

`POST /api/fares/cheapest-dates`

## Request

- Base URL: `https://ignav.com`
- URL: `https://ignav.com/api/fares/cheapest-dates`
- Auth: API key in header `X-Api-Key`

Find the lowest fare for each departure date in a window.

## Request body

- CheapestDatesRequest
  - `origin` string, required
  - `destination` string, required
  - `departure_date_range` DepartureDateRange, required
    - `start` string, date, required
    - `end` string, date, required
  - `stay_days` integer, nullable
  - `adults` integer
  - `children` integer
  - `infants_in_seat` integer
  - `infants_on_lap` integer
  - `cabin_class` 'economy' | 'premium_economy' | 'business' | 'first'
  - `max_stops` integer, nullable
  - `min_carry_on_bags` integer, nullable
  - `min_checked_bags` integer, nullable
  - `max_price` integer, nullable
  - `departure_time_range` TimeRangeInput
    - `earliest_hour` integer, nullable
    - `latest_hour` integer, nullable
    - `arrival_earliest_hour` integer, nullable
    - `arrival_latest_hour` integer, nullable
  - `return_time_range` TimeRangeInput
    - `earliest_hour` integer, nullable
    - `latest_hour` integer, nullable
    - `arrival_earliest_hour` integer, nullable
    - `arrival_latest_hour` integer, nullable
  - `market` string

## Response `200`

Successful Response

- CheapestDatesResponseModel
  - `origin` string, required
  - `destination` string, required
  - `dates` CheapestDateModel[], required
    - `departure_date` string, required
    - `return_date` string, nullable
    - `price` PriceModel, required
      - `amount` number, required
      - `currency` string, required
      - `status` 'verified' | 'unverified', required
  - `observed_at` string, date-time, nullable: UTC time Ignav finished retrieving these prices; null when unknown. Not a guarantee of current fares.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `424`: Failed Dependency
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/ignav/apis/ignav-public-api.md) · [All operations](https://skmtc.dev/ignav/apis/ignav-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ignav/apis/ignav-public-api/revisions/1b4cd3e8ca20?raw)