---
title: "Route"
url: "https://kongair.terwilligar.com/apis/kong-air-route-api-2-1-9/versions/f24fd3bb-3f0e-4e64-ad5f-4be59552336a/schemas/Route"
---

> Full API specification: https://kongair.terwilligar.com/apis/kong-air-route-api-2-1-9/versions/f24fd3bb-3f0e-4e64-ad5f-4be59552336a.md

# Route

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: KongAir Route API
  version: 1.0.0
servers:
  - url: https://api.kongair.com/v1
    description: Production server
components:
  schemas:
    FlightSegment:
      type: object
      properties:
        flight_number:
          type: string
          example: KA1234
        airline:
          type: string
          example: KongAir
        departure_airport:
          type: string
          example: JFK
        arrival_airport:
          type: string
          example: LAX
        departure_time:
          type: string
          format: date-time
          example: 2025-06-01T08:30:00Z
        arrival_time:
          type: string
          format: date-time
          example: 2025-06-01T11:30:00Z
        duration:
          type: string
          example: 06:15:00
          description: Flight duration in HH:MM:SS format.
    Route:
      type: object
      properties:
        origin:
          type: string
          example: JFK
        destination:
          type: string
          example: LAX
        total_distance:
          type: number
          format: float
          example: 3972
          description: Total distance of the route in kilometers.
        total_duration:
          type: string
          example: 06:15:00
          description: Total estimated duration of the route in HH:MM:SS format.
        flights:
          type: array
          description: List of flights in the shortest route.
          items:
            $ref: "#/components/schemas/FlightSegment"
```