{"openapi":"3.1.0","info":{"title":"Flightradar24 API (Bowmark)","version":"e833508f87ff","description":"Live flight tracking: where a given flight number, callsign or tail registration is right now, every aircraft airborne inside a map box, an airport's arrivals and departures boards and its punctuality, an airport or airline record by code, the airframe behind a registration, an airline's fleet, a flight's history and its full flown track. Two functions are callable so far — looking up an airline by its ICAO or IATA code, and an airport's arrivals board; the other ten are declared and not built yet.\n\nEvery function Bowmark has for Flightradar24 (flightradar24.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/flightradar24/getAirline":{"post":{"operationId":"getAirline","summary":"Name the carrier behind an airline code.","description":"Name the carrier behind an airline code. Pass `icao` with a 3-letter ICAO code (\"BAW\", \"DLH\", \"AAL\") or `iata` with a 2-character IATA one (\"BA\", \"LH\", \"AA\") — exactly one, since the two can disagree. Returns Flightradar24's own record: the carrier's name and its IATA/ICAO pair, from a directory of 2,745 airlines. Built for the caller who holds a callsign prefix or an operator code from somewhere else and needs to render a name a person can read rather than a code they cannot. `airlines` is a LIST because an IATA lookup is genuinely ambiguous — 108 IATA codes are shared by two or more carriers in this directory, since IATA reassigns retired codes — while an ICAO lookup returns at most one, every ICAO code being distinct. An empty list means Flightradar24 lists no such carrier, which is an answer rather than a failure. `iata` is null for 61% of carriers: IATA assigns codes only to airlines that need them for interlining, so most cargo, charter and business operators genuinely have none. The record is deliberately thin — a name and two codes is all Flightradar24 publishes at this door, and it does not carry fleet size, hubs, callsign or country.\n\nCalls `bowmark.providers.flightradar24.getAirline`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<flightradar24AirlineLookup>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"arg0":{}},"required":["arg0"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/flightradar24/getAirportArrivals":{"post":{"operationId":"getAirportArrivals","summary":"Reads an airport's arrivals board for a code — 3-letter IATA (\"LHR\") or 4-letter ICAO (\"EGLL\"), both accepted.","description":"Reads an airport's arrivals board for a code — 3-letter IATA (\"LHR\") or 4-letter ICAO (\"EGLL\"), both accepted. Returns ONE page (up to `limit`, default and max 100) anchored at now — the same page a visitor's first load sees — with each row's flight number, callsign, airline, origin airport, Flightradar24's own status text/colour, live-position flag, scheduled/estimated/actual arrival times, and the terminal/gate AT THIS AIRPORT (never the origin's). An airport code Flightradar24 does not recognize answers an EMPTY board (`rows: []`) rather than throwing — the site itself answers that way, and it is a different fact from a malformed code, which throws before any request is sent. Status is kept as Flightradar24's own words (\"Estimated 04:29\", \"Delayed 06:11\", \"Scheduled\", \"Canceled\") rather than mapped onto an invented enum, because one capture is not grounds to claim the complete set of strings the site can emit.\n\nCalls `bowmark.providers.flightradar24.getAirportArrivals`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<flightradar24ArrivalsBoard>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"arg0":{}},"required":["arg0"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}}}}}