---
title: "Get a specific flight by flight number"
url: "https://kongair.kong-sales-engineering.com/apis/flights/versions/ed7e4136-fab1-43a6-9f89-2f3089d8f879/operations/get-flight-by-number"
---

> Full API specification: https://kongair.kong-sales-engineering.com/apis/flights/versions/ed7e4136-fab1-43a6-9f89-2f3089d8f879.md

# Get a specific flight by flight number

`GET` `/flights/{flightNumber}`

Operation ID: `get-flight-by-number`

Returns a specific flight given its flight number

## Path parameters

- `flightNumber` (string, required) - The flight number

## Responses

- `200` - Successful response with the requested flight
- `404` - Flight not found

## 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/{flightNumber}:
    get:
      summary: Get a specific flight by flight number
      description: |
        Returns a specific flight given its flight number
      tags:
        - flight-data
      operationId: get-flight-by-number
      parameters:
        - name: flightNumber
          in: path
          description: The flight number
          required: true
          style: simple
          schema:
            type: string
            example: KA0284
      responses:
        "200":
          description: Successful response with the requested flight
          headers:
            hostname:
              description: The hostname of the machine fulfilling the request.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Flight"
              examples:
                Example Flight KD924:
                  value: |
                    {
                      "number": "KD924",
                      "route_id": "LHR-SFO",
                      "scheduled_departure": "2024-03-20T09:12:28Z",
                      "scheduled_arrival": "2024-03-20T19:12:28Z"
                    }
        "404":
          description: Flight not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
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
```