Flight Status API docs

Authentication

API key (header: X-API-Key)

Send your key on every request. Do not put keys in client-side code or public repos. Rotate keys from the dashboard if a secret is exposed.

X-API-Key: YOUR_API_KEY

Rate limits

Default catalog limit: From 10 req/min. Plan-specific limits apply after you subscribe. When throttled, expect 429 with a retryable response — back off and retry with jitter.

• Get flight status: Plan-based
• Get flight schedule: Plan-based

Errors

Errors return JSON with a machine-readable code and message. Common platform codes:

• 401 — missing or invalid API key
• 403 — key valid but not entitled for this API or plan
• 404 — resource or path not found
• 429 — rate limit exceeded; retry later
• 5xx — upstream or platform failure; retry with backoff

Endpoint-specific errors are listed under each endpoint below.

Versioning

Current documented version: v1. Prefer pinning the version path shown in examples. Breaking changes ship under a new version; check the changelog for platform updates.

Get flight status

Retrieve status for a flight on a date.

Parameters

Example code

curl -s "https://yypop.apiseeker.com/v1/flight-status" \
  -H "X-API-Key: YOUR_API_KEY"

Response example

{
  "flight": "AI101",
  "date": "2026-08-13",
  "status": "Scheduled",
  "departure": {
    "airport": "DEL",
    "timeLocal": "08:00"
  },
  "arrival": {
    "airport": "BOM",
    "timeLocal": "10:15"
  }
}

Errors

• 400 — Invalid parameters
• 401 — Missing or invalid API key
• 404 — Flight not found

Get flight schedule

List scheduled legs for a flight number.

Parameters

Example code

curl -s "https://yypop.apiseeker.com/v1/flight-status/schedule" \
  -H "X-API-Key: YOUR_API_KEY"

Response example

{
  "flight": "AI101",
  "schedule": [
    {
      "date": "2026-08-13",
      "status": "Scheduled",
      "departure": "DEL"
    }
  ]
}

Errors

• 400 — Invalid parameters
• 404 — Flight not found