API Reference
  1. Mercury API
  2. Flights

Cheapest fare per day for a month (fare calendar)

get
https://example.com/v1/flights/fare-calendar

Return the cheapest observed flight price for every day in the requested month, with tercile-based low/medium/high tier classification computed across this response. Phase 1 of the fare-calendar feature (MER-126). Individual date failures are returned as priceConfidence: "unavailable" rather than a 5xx.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required
length between 3 and 3
^[A-Za-z]{3}$

3-letter IATA airport code.

string
required
length between 3 and 3
^[A-Za-z]{3}$

3-letter IATA airport code.

string
required
^([1-9]\d{3}|0[1-9]\d{2}|00[1-9]\d|000[1-9])-(0[1-9]|1[0-2])$

Calendar month to query (YYYY-MM).

string
enum
Defaults to economy

Cabin class.

Allowed:
integer
1 to 9
Defaults to 1

Adult passenger count.

integer
0 to 9
Defaults to 0

Child passenger count.

integer
0 to 9
Defaults to 0

Infant passenger count.

string
^[A-Za-z]{3}$
Defaults to EUR

ISO 4217 currency code (default EUR).

Responses

401

Missing or invalid authentication.

422

Invalid query parameters.

429

Per-route rate limit exceeded.

503

Fare calendar service unavailable.

Updated 3 months ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?