Skip to main content
POST
/
v1
/
price_monitoring
Monitor price for a specific origin, destination, and dates pair
curl --request POST \
  --url https://api.example.com/v1/price_monitoring \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "origin": "PAR",
  "destination": "NYC",
  "departure_date": "<string>",
  "return_date": "<string>",
  "direct_only": true,
  "max_price": 1,
  "include_carriers": [
    "<string>"
  ],
  "exclude_carriers": [
    "<string>"
  ],
  "adults": 1,
  "children": 1,
  "infants": 1,
  "currency": "<string>",
  "locale": "<string>"
}
'
{
  "status": "ok",
  "monitored_at": "2026-06-01T12:34:56.000Z",
  "flight": {
    "offer_token": "oft_7c2e9a1b4d",
    "total_price": {
      "amount": 289.99,
      "value": 123,
      "currency": "USD",
      "decimal_places": 2
    },
    "outbound_carrier": {
      "code": "DL",
      "name": "Delta Air Lines",
      "flight_number": "DL263"
    },
    "inbound_carrier": {
      "code": "DL",
      "name": "Delta Air Lines",
      "flight_number": "DL263"
    },
    "outbound_stops": 0,
    "inbound_stops": 1,
    "outbound_duration_minutes": 470,
    "inbound_duration_minutes": 520,
    "outbound_departure_local": "2026-07-15T10:15:00.000Z",
    "outbound_arrival_local": "2026-07-15T13:05:00.000Z",
    "inbound_departure_local": "2026-07-22T17:40:00.000Z",
    "inbound_arrival_local": "2026-07-23T07:25:00.000Z",
    "cabin_class": "economy",
    "fare_brand": "Main"
  },
  "request_echo": null
}
Watch a specific route and date pair over time so an agent can act when the fare drops. Use it for prompts like “alert me when Paris to New York for June 17 to 26 goes under €400”. Each response includes the current cheapest cached fare and an offer token you can pass to flight_search when the user decides to book. Cache-only; never triggers a live call.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
origin
string
required
Example:

"PAR"

​
destination
string
required
Example:

"NYC"

​
departure_date
string
required
Pattern: ^\d{4}-\d{2}-\d{2}$
​
return_date
string
Pattern: ^\d{4}-\d{2}-\d{2}$
​
origin_type
enum<string>
Available options:
city,
airport
​
destination_type
enum<string>
Available options:
city,
airport
​
cabin_class
enum<string>
Available options:
economy,
premium_economy,
business,
first
​
direct_only
boolean
​
max_price
number
Required range: x > 0
​
include_carriers
string[]
​
exclude_carriers
string[]
​
adults
integer
default:1
Required range: x >= 1
​
children
integer
Required range: x >= 0
​
infants
integer
Required range: x >= 0
​
currency
string
​
locale
string

Response

Cheapest cached itinerary, or stale on a cache miss

​
status
string
required
Example:

"ok"

​
monitored_at
string
Example:

"2026-06-01T12:34:56.000Z"

​
flight
object
​
request_echo
unknown