GOgojinko
Discovery

Monitor price for a specific origin, destination, and dates pair

post/v1/price_monitoring

Request

  • Base URL
    https://api.gojinko.com
  • URL
    https://api.gojinko.com/v1/price_monitoring
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

originstring required
destinationstring required
departure_datestring required
return_datestring
origin_type'city' | 'airport'

How to read the code: city searches every airport of the city, airport only that one airport. Omit it and the platform applies one rule: a code that names a multi-airport city is searched as the city; every other code is searched as the airport. Untyped NYC, LON or PAR is the city; untyped JFK, LHR or CDG is the airport; and untyped LAX, MIA or LAS — codes a city shares with its main airport — is the CITY, so results can land at any airport of that city. If the user named the airport, send airport; if they named the city, omit the field.

destination_type'city' | 'airport'

How to read the code: city searches every airport of the city, airport only that one airport. Omit it and the platform applies one rule: a code that names a multi-airport city is searched as the city; every other code is searched as the airport. Untyped NYC, LON or PAR is the city; untyped JFK, LHR or CDG is the airport; and untyped LAX, MIA or LAS — codes a city shares with its main airport — is the CITY, so results can land at any airport of that city. If the user named the airport, send airport; if they named the city, omit the field.

cabin_class'economy' | 'premium_economy' | 'business' | 'first'
direct_onlyboolean

Only direct flights. Cached fares record whether a fare is direct but not how many stops it makes, so this is the only stop filter here; POST /v1/flight_search takes max_stops.

max_totalnumber

Caps the cached fare’s total. Cached fares are priced for one adult, so this is the cap on one adult’s fare.

include_carriersstring[]
exclude_carriersstring[]
accuracy'standard' | 'high'

How strict the freshness check on cached fares is. standard (default) returns fares estimated to be at least 80% likely to still be available at the cached price; high raises that to 95%, so fewer fares come back.

currencystring
localestring

Example request

{
  "origin": "PAR",
  "destination": "NYC",
  "intent": {
    "user_intent": "find a cheap flight to Tokyo"
  }
}

Response

Cheapest cached itinerary, or stale on a cache miss

priced_for'one_adult' required

Whose price the cached fares in this answer are: always one_adult. Every cached total is one adult's fare; this request takes no passenger counts. Price the whole party with POST /v1/flight_search.

status'ok' | 'stale' required

ok: the cache held a matching itinerary and the cheapest is in flight. stale: no matching cached itinerary, and flight is absent; retry later, or price live with POST /v1/flight_search.

monitored_atstring
request_echounknown

Example response

{
  "priced_for": "one_adult",
  "status": "ok",
  "monitored_at": "2026-06-01T12:34:56Z",
  "flight": {
    "offer_token": "oft_7c2e9a1b4d",
    "total_price": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "outbound_carrier": {
      "code": "DL",
      "name": "Delta Air Lines",
      "flight_number": "263"
    },
    "inbound_carrier": {
      "code": "DL",
      "name": "Delta Air Lines",
      "flight_number": "263"
    },
    "inbound_stops": 1,
    "outbound_duration_minutes": 470,
    "inbound_duration_minutes": 520,
    "outbound_departure_local": "2026-07-15T10:15:00-04:00",
    "outbound_arrival_local": "2026-07-15T13:05:00-07:00",
    "inbound_departure_local": "2026-07-22T17:40:00-07:00",
    "inbound_arrival_local": "2026-07-23T07:25:00-04:00",
    "cabin_class": "economy",
    "fare_brand": "Main"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.