---
title: "Get KongAir planned flights"
url: "https://kongair.kong-sales-engineering.com/apis/flights/versions/ed7e4136-fab1-43a6-9f89-2f3089d8f879/operations/get-flights"
---

> Full API specification: https://kongair.kong-sales-engineering.com/apis/flights/versions/ed7e4136-fab1-43a6-9f89-2f3089d8f879.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: 1.0.0
servers:
  - url: https://shared-services.kong-sales-engineering.com/kongair
    description: KongAir API Server
paths:
  /flights:
    get:
      summary: Get KongAir planned flights
      description: |
        Returns all the scheduled flights for a given day
      tags:
        - flight-data
      operationId: get-flights
      parameters:
        - name: date
          in: query
          description: Filter by date (defaults to current day)
          required: false
          style: form
          schema:
            type: string
            format: date
      responses:
        "200":
          description: Successful respone with scheduled flights
          headers:
            hostname:
              description: The hostname of the machine fulfilling the request.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/Flight"
              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"
                       }
                    ]
security:
  - basicAuth: []
components:
  schemas:
    Flight:
      type: object
      properties:
        number:
          type: string
        route_id:
          type: string
        scheduled_departure:
          type: string
          format: date-time
        scheduled_arrival:
          type: string
          format: date-time
      required:
        - number
        - route_id
        - scheduled_departure
        - scheduled_arrival
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
```