---
title: "Get KongAir planned flights"
url: "https://devportal.jilson.dev/apis/kong-air-ap-is-1-0-0/versions/7a8b8282-7fdc-432a-a618-88582e8fb712/operations/get-flights"
---

> Full API specification: https://devportal.jilson.dev/apis/kong-air-ap-is-1-0-0/versions/7a8b8282-7fdc-432a-a618-88582e8fb712.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 response with scheduled flights

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: KongAir APIs
  version: 1.0.0
servers:
  - url: https://api.kongair.dev
    description: KongAir API Dev
paths:
  /flights:
    get:
      summary: Get KongAir planned flights
      description: Returns all the scheduled flights for a given day
      operationId: get-flights
      tags:
        - 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 response with scheduled flights
          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:
  - ApiKeyAuth: []
  - BearerAuth: []
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:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
```