# FlightLabs (GoFlightLabs)

> Real-time flight tracker and status API: live positions, historical flights, schedules, delays, prices, airlines, airports, and routes.

FlightLabs is a REST API for aviation data. Use it to track flights worldwide, look up airport schedules and delays, search ticket prices, and query airline/airport metadata. Authentication uses an `access_key` query parameter. Get a key at https://www.goflightlabs.com/register.

Product site: https://www.goflightlabs.com

## Key pages

- [Homepage](https://www.goflightlabs.com): Product overview and signup
- [API Dashboard / docs hub](https://www.goflightlabs.com/dashboard): Public documentation hub (also reached via /documentation)
- [MCP for AI agents](https://www.goflightlabs.com/mcp): Connect Claude, Cursor, ChatGPT, and other MCP clients
- [Pricing](https://www.goflightlabs.com/#pricing): Plans and trial
- [Postman collection](https://www.goflightlabs.com/FlightLabs.postman_collection.json): Importable request collection

## Base URL

```
https://www.goflightlabs.com
```

All API requests require `?access_key=YOUR_ACCESS_KEY`.

## Authentication

Pass your access key as a query parameter on every request:

```
GET /flights?access_key=YOUR_ACCESS_KEY&flightIata=BA179
```

Keys are created after signup. Keep the key secret — never expose it in client-side JavaScript or public repos. Rotate it from the account area if compromised.

## MCP (AI agents)

FlightLabs exposes the same data via Model Context Protocol:

- MCP endpoint: `https://mcp.goflightlabs.com/mcp?access_key=YOUR_ACCESS_KEY`
- Discovery: https://www.goflightlabs.com/.well-known/mcp.json
- Tools: `flights.realtime`, `flights.historical`, `flights.prices`, `flights.delays`, `flights.schedules`, `flights.by_number`, `flights.by_airline`, `airlines.list`, `airlines.routes`, `airports.by_filter`

Claude Desktop / Cursor example:

```json
{
  "mcpServers": {
    "goflightlabs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.goflightlabs.com/mcp?access_key=YOUR_ACCESS_KEY"
      ]
    }
  }
}
```

## Endpoints

### Real-time flights — `GET /flights`

Live positions and status (updated ~every 10 minutes).

Docs: https://www.goflightlabs.com/real-time

Example:

```
GET /flights?access_key=YOUR_ACCESS_KEY&flightIata=BA179
```

Useful params: `limit`, `flightIata`, `flightIcao`, `flightNum`, `airlineIata`, `airlineIcao`, `depIata`, `depIcao`, `arrIata`, `arrIcao`, `regNum`, `hex`

### Historical flights — `GET /historical`

Historical departures or arrivals for an airport (`date_from`+`date_to` ≤12h, or a single `date`).

Docs: https://www.goflightlabs.com/flights-history

### Flight schedules — `GET /advanced-flights-schedules`

Airport timetable of scheduled departures or arrivals.

Docs: https://www.goflightlabs.com/flights-schedules

### Flight delays — `GET /flight_delays`

Flights delayed above a minimum number of minutes.

Docs: https://www.goflightlabs.com/flight-delay

### Flight by number — `GET /flight`

Info for a specific flight number / IATA.

Docs: https://www.goflightlabs.com/flight-info-by-flight-number

### Flights by airline — `GET /flights-by-airline`

Live flights filtered by airline.

Docs: https://www.goflightlabs.com/flights-airline

### Flight prices — `GET /retrieveFlights`

Search one-way or roundtrip prices between airports.

Docs: https://www.goflightlabs.com/flight-prices

### Airlines — `GET /airlines`

List / filter airlines.

Docs: https://www.goflightlabs.com/retrieve-airlines

### Airline routes — `GET /routes`

Routes operated by an airline.

Docs: https://www.goflightlabs.com/retrieve-routes

### Airports by filter — `GET /airports-by-filter`

Search airports by IATA/ICAO, country, city, etc.

Docs: https://www.goflightlabs.com/airports-by-filters

### Other public docs

- Flights with CallSign: https://www.goflightlabs.com/flights-with-callSign
- Future flights: https://www.goflightlabs.com/future-flights
- Flight data by date: https://www.goflightlabs.com/flight-data-by-date
- Countries: https://www.goflightlabs.com/retrieve-countries
- Cities by IATA: https://www.goflightlabs.com/cities-by-iata

## Optional

- [MCP setup page](https://www.goflightlabs.com/mcp)
- [MCP discovery JSON](https://www.goflightlabs.com/.well-known/mcp.json)
- [robots.txt](https://www.goflightlabs.com/robots.txt)
- [Sitemap](https://www.goflightlabs.com/sitemap.xml)