---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/flight-status
---
# Flight Status

Look up live flight status by flight number, or check the full departure/arrival board for any airport worldwide. See real-time delays, gate and terminal assignments, and scheduled vs actual times. Essential for tracking connections, pickups, and travel disruptions.

- **Version:** 0.02
- **Categories:** data, productivity

## Skills (3)

### Check Flight Status (`check_flight`)

Look up a specific flight by its number to see if it is on time, delayed, or cancelled. Also shows the gate, terminal, and aircraft details.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `flight_number` | string | Yes | IATA flight number (e.g. 'BA115', 'DL1', 'UA900', 'QF1') |
| `date` | string | No | Flight date in YYYY-MM-DD format (defaults to today) |

**Returns:** Current flight status with delay info, gate, terminal, and scheduled vs actual times

**Examples:**

*Is BA115 running on time today?:*

```json
{
  "flight_number": "BA115"
}
```

*What is the status of Delta flight 1 on March 25th?:*

```json
{
  "flight_number": "DL1",
  "date": "2026-03-25"
}
```

*Has my Qantas flight QF1 been delayed?:*

```json
{
  "flight_number": "QF1",
  "date": "2026-03-22"
}
```

### Airport Departures (`airport_departures`)

See what flights are leaving an airport in the next few hours. Use this to check the departure board before heading to the airport or to spot delays.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `airport` | string | Yes | Airport IATA code (e.g. 'LHR', 'JFK', 'SYD', 'DXB') |
| `hours_ahead` | number | No | Hours ahead to show departures for (1-12, default 6) [default: 6] |

**Returns:** Upcoming departures with flight numbers, destinations, times, delays, and gates

**Examples:**

*What flights are leaving Heathrow in the next few hours?:*

```json
{
  "airport": "LHR"
}
```

*Show me departures from JFK in the next 3 hours:*

```json
{
  "airport": "JFK",
  "hours_ahead": 3
}
```

### Airport Arrivals (`airport_arrivals`)

See what flights are arriving at an airport in the next few hours. Handy for picking someone up or checking if an inbound flight is delayed.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `airport` | string | Yes | Airport IATA code (e.g. 'LHR', 'JFK', 'SYD', 'DXB') |
| `hours_ahead` | number | No | Hours ahead to show arrivals for (1-12, default 6) [default: 6] |

**Returns:** Upcoming arrivals with flight numbers, origins, times, delays, and gates

**Examples:**

*When is the next flight landing at Sydney?:*

```json
{
  "airport": "SYD"
}
```

*What is arriving at Dubai in the next 2 hours?:*

```json
{
  "airport": "DXB",
  "hours_ahead": 2
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call flight-status check_flight --flight_number BA115

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"flight-status","skill":"check_flight","input":{"flight_number":"BA115"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Can I look up a flight by flight number?

Yes. `check_flight` looks up a specific flight number and shows whether it is on time, delayed, or cancelled, plus gate, terminal, and timing details.

### Can I see an airport departure or arrival board?

Yes. `airport_departures` and `airport_arrivals` show the upcoming board for an airport code like LHR, JFK, or SYD, with a time window controlled by `hours_ahead`.

### Do I need to know the IATA code first?

If you do not know it, use the flight-search `find_airport` skill first. That is the easiest way to get the airport code before checking status or boards.

### What live status details are included?

You get delay minutes, gate, terminal, scheduled and actual times, and aircraft details when they are available.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs