{ "openapi": "3.0.1", "info": { "title": "Flight Status API - OAG Flight Schedules, Airports, Airlines", "description": "Real-time flight status and flight schedules from the OAG API: departure and arrival times, delays, gates, terminals, diversions, aircraft, codeshares and seats by flight number, route or airport, plus airport, airline and aircraft type reference data. Bring your own key.", "version": "0.1", "x-build-id": "u81fWcXZNvPwmX7qZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~flight-status-schedules-aviation-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-flight-status-schedules-aviation-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nabeelbaghoor~flight-status-schedules-aviation-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-flight-status-schedules-aviation-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nabeelbaghoor~flight-status-schedules-aviation-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-flight-status-schedules-aviation-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "What to get", "enum": [ "flightStatus", "flightSearch", "schedules", "airports", "airlines", "aircraftTypes" ], "type": "string", "description": "Flight status reads each flight number's instances (scheduled, estimated and actual times, gates, delays, diversions, seats). Flight search reads every flight matching a route, airport, airline, country or tail number. Flight schedules reads the effective schedule (date range and operating days) of IATA flight numbers. Airports, Airlines and Aircraft types read OAG master reference data.", "default": "flightStatus" }, "flightNumbers": { "title": "Flight numbers", "type": "array", "description": "Flight status and Flight schedules. One flight per line: an airline code and a number, such as BA117, BAW117 or U2 8001. Schedules take 2 character IATA airline codes only.", "items": { "type": "string" } }, "departureDate": { "title": "Departure date or range", "type": "string", "description": "Flight modes and Flight schedules. Local departure date in ISO 8601: 2026-10-20, a range such as 2026-10-20/2026-10-27 (at most 31 days), or for flight modes a time window such as 2026-10-20T06:00/2026-10-20T12:00. Leave empty for today." }, "arrivalDate": { "title": "Arrival date or range", "type": "string", "description": "Flight status and Flight search. Local arrival date, range or time window in the same format, to search by arrival instead of (or as well as) departure." }, "departureAirports": { "title": "Departure airports", "type": "array", "description": "Flight search only. IATA, ICAO or FAA airport codes flights depart from, such as LHR or EGLL. Give one airport for a departures board.", "items": { "type": "string" } }, "arrivalAirports": { "title": "Arrival airports", "type": "array", "description": "Flight search only. Airport codes flights arrive at. Combine with departure airports for a route, or use alone for an arrivals board.", "items": { "type": "string" } }, "carrierCodes": { "title": "Airline codes", "type": "array", "description": "Flight search only. IATA or ICAO airline codes, such as BA, AAL or U2.", "items": { "type": "string" } }, "departureCountry": { "title": "Departure country", "type": "string", "description": "Flight search only. Two letter ISO 3166-1 code of the country flights depart from, such as US." }, "arrivalCountry": { "title": "Arrival country", "type": "string", "description": "Flight search only. Two letter ISO 3166-1 code of the country flights arrive in, such as GB." }, "aircraftRegistration": { "title": "Aircraft registration (tail number)", "type": "string", "description": "Flight search only. Every flight flown by one aircraft, such as N425HB." }, "includeDiverted": { "title": "Include diverted flights", "type": "boolean", "description": "Flight search with an arrival airport only. Also return flights diverted to that airport.", "default": false }, "content": { "title": "Extra content", "type": "array", "description": "Flight status and Flight search. Extra data to include. OAG may charge extra for Seats, Actual seats and Extended schedules, depending on your plan.", "items": { "type": "string", "enum": [ "Status", "Seats", "ActualSeats", "ExtendedSchedules" ], "enumTitles": [ "Status (estimated and actual times, gates, flight state)", "Seats (OAG predicted seat capacity)", "Actual seats", "Extended schedules (booking classes, meals)" ] }, "default": [ "Status" ] }, "flightTypes": { "title": "Flight types", "type": "array", "description": "Flight status and Flight search. Leave empty for all types.", "items": { "type": "string", "enum": [ "Scheduled", "Unscheduled", "GA" ], "enumTitles": [ "Scheduled", "Unscheduled", "General aviation" ] } }, "serviceTypes": { "title": "Service types", "type": "array", "description": "Flight status and Flight search. Leave empty for all services.", "items": { "type": "string", "enum": [ "Passenger", "Cargo" ], "enumTitles": [ "Passenger", "Cargo" ] } }, "codeshare": { "title": "Codeshare", "type": "array", "description": "Flight status and Flight search. Only operating flights, only marketing codeshares, or leave empty for both.", "items": { "type": "string", "enum": [ "Operating", "Marketing" ], "enumTitles": [ "Operating flights", "Marketing (codeshare) flights" ] } }, "codeTypes": { "title": "Code types", "type": "array", "description": "Which code standards your airport, airline and aircraft codes use. Leave empty to let the actor choose: IATA or ICAO by code length for flight numbers, IATA and ICAO elsewhere.", "items": { "type": "string", "enum": [ "IATA", "ICAO", "FAA" ], "enumTitles": [ "IATA", "ICAO", "FAA (airports and aircraft only)" ] } }, "codes": { "title": "Codes to look up", "type": "array", "description": "Airports, Airlines and Aircraft types. Airport codes (LHR, EGLL), airline codes (BA, AAL) or aircraft type codes (320, A320). Leave empty to list everything that matches the other filters.", "items": { "type": "string" } }, "countryCodes": { "title": "Countries", "type": "array", "description": "Airports only. Two letter ISO country codes; returns the airports in these countries.", "items": { "type": "string" } }, "cityCodes": { "title": "Cities", "type": "array", "description": "Airports only. City codes such as LON or NYC; returns every airport serving the city.", "items": { "type": "string" } }, "names": { "title": "Names", "type": "array", "description": "Airlines: full or partial airline names. Aircraft types: full or partial manufacturer names, such as Airbus or Boeing.", "items": { "type": "string" } }, "aircraftModels": { "title": "Aircraft models", "type": "array", "description": "Aircraft types only. Full or partial model names, such as A320 or 787.", "items": { "type": "string" } }, "publishingCarriersOnly": { "title": "Schedule publishing airlines only", "type": "boolean", "description": "Airlines only. Only airlines whose commercial schedules OAG publishes.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most rows this run returns and charges for. Each page of up to 1000 rows is one request on your OAG plan.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Pacing. A rate limit answer is waited out and retried.", "default": 60 }, "apiKey": { "title": "API key", "type": "string", "description": "Your own OAG subscription key (primary or secondary), from your profile on developers.oag.com. Stored as a secret and sent only in the Subscription-Key header to api.oag.com; it is never logged. You can instead set the DATA_API_KEY environment secret." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }