GOgojinko
Discovery

Flights observed between two places on exact dates (no price)

Returns the trips the flight catalog has observed for one origin, one destination and an exact date pair. trip_type says which kind: oneway (no return_date) or roundtrip (return_date required); a round trip is an outbound + inbound pairing that was actually observed together, never a combination built from two one-ways. The answer carries no price, and last_seen is when a fare search last observed the trip — not a statement that it can be booked. Results are paged: send pagination.next_page_token back as page_token until it is empty.

post/v1/flight_schedule

Request

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

Request body

originstring required
destinationstring required
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.

trip_type'oneway' | 'roundtrip' required

oneway returns trips observed as one-way offers and takes no return_date. roundtrip returns observed outbound + inbound pairings and requires return_date.

departure_datestring required

Local departure day of the outbound journey.

return_datestring

Local departure day of the inbound journey. Required when trip_type is roundtrip; not accepted when it is oneway.

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

Filters on the trip’s cabin (the highest over its segments). Omit for all cabins — unlike flight search there is no economy default.

max_stopsinteger

Most stops allowed in EACH direction. Omit for no bound.

limitinteger

Page size. Defaults to 50.

page_tokenstring

pagination.next_page_token of the previous page. Send it with the same request fields.

Example request

{
  "origin": "BOS",
  "destination": "NCE",
  "trip_type": "roundtrip",
  "departure_date": "2026-10-11",
  "return_date": "2026-10-18",
  "max_stops": 1
}

Response

Observed trips; trips is empty when nothing matches

totalinteger required

Trips matching the whole request across all pages. A lower bound when truncated is true.

truncatedboolean required

True when an airport pair held more trips than one catalog read covers. Narrow by cabin_class, max_stops or a single airport to see the rest.

Example response

{
  "trips": [
    {
      "trip_type": "roundtrip",
      "validating_carrier": "AF",
      "last_seen": "2026-09-30T04:12:09Z",
      "slices": [
        {
          "origin": "BOS",
          "destination": "NCE",
          "stops": 1,
          "segments": [
            {
              "marketing_carrier": "AF",
              "marketing_carrier_info": {
                "code": "AF",
                "name": "Air France"
              },
              "operating_carrier": "DL",
              "operating_carrier_info": {
                "code": "AF",
                "name": "Air France"
              },
              "flight_number": "333",
              "depart": {
                "airport": "BOS",
                "city_code": "BOS",
                "city_name": "Boston",
                "time_local": "2026-10-11T18:25"
              },
              "arrive": {
                "airport": "BOS",
                "city_code": "BOS",
                "city_name": "Boston",
                "time_local": "2026-10-11T18:25"
              }
            }
          ]
        }
      ]
    }
  ],
  "total": 116
}

Changes

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