---
title: "Get KongAir planned flights"
url: "https://dev.kong-air.com/apis/kong-air-flights-0/versions/c6e88dea-cb80-470b-b387-23f2bb41f1f0/operations/get-flights"
---

> Full API specification: https://dev.kong-air.com/apis/kong-air-flights-0/versions/c6e88dea-cb80-470b-b387-23f2bb41f1f0.md

# Get KongAir planned flights

`GET` `/flights`

Operation ID: `get-flights`

Returns all the scheduled flights for a given day

## Query parameters

- `date` (string, date, optional) - Filter by date (defaults to current day)

## Responses

- `200` - Successful respone with scheduled flights

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Flights Service
  version: 0.2.0
servers:
  - description: KongAir API Server
    url: https://api.kong-air.com
paths:
  /flights:
    get:
      description: |
        Returns all the scheduled flights for a given day
      operationId: get-flights
      parameters:
        - description: Filter by date (defaults to current day)
          in: query
          name: date
          required: false
          schema:
            format: date
            type: string
          style: form
      responses:
        "200":
          content:
            application/json:
              examples:
                Example Flights List:
                  value: |
                    [
                       {
                         "number": "KD924",
                         "route_id": "LHR-SFO",
                         "scheduled_departure": "2024-03-20T09:12:28Z",
                         "scheduled_arrival": "2024-03-20T19:12:28Z"
                       },
                       {
                         "number": "KD925",
                         "route_id": "SFO-LHR",
                         "scheduled_departure": "2024-03-21T09:12:28Z",
                         "scheduled_arrival": "2024-03-21T19:12:28Z"
                       }
                    ]
              schema:
                items:
                  $ref: "#/components/schemas/Flight"
                type: array
          description: Successful respone with scheduled flights
          headers:
            hostname:
              description: The hostname of the machine fulfilling the request.
              schema:
                type: string
      summary: Get KongAir planned flights
      tags:
        - flight-data
components:
  schemas:
    Flight:
      properties:
        number:
          type: string
        route_id:
          type: string
        scheduled_arrival:
          format: date-time
          type: string
        scheduled_departure:
          format: date-time
          type: string
      required:
        - number
        - route_id
        - scheduled_departure
        - scheduled_arrival
      type: object
```