---
title: "FlightSearchResponse"
url: "https://kongair.terwilligar.com/apis/llm-flight-booking-assistant-1-0-0/versions/76f089d9-b12c-4dd8-a400-e4c611faf544/schemas/FlightSearchResponse"
---

> Full API specification: https://kongair.terwilligar.com/apis/llm-flight-booking-assistant-1-0-0/versions/76f089d9-b12c-4dd8-a400-e4c611faf544.md

# FlightSearchResponse

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Flight LLM Booking API
  version: 1.0.0
servers:
  - url: https://api.example.com/v1
    description: Production server
    variables:
      version:
        enum:
          - v1
          - v2
        default: v1
      region:
        enum:
          - us
          - eu
          - asia
        default: us
        description: Geographic region
  - url: https://sandbox.example.com/{version}
    description: Sandbox server
    variables:
      version:
        default: v1
components:
  schemas:
    Flight:
      type: object
      properties:
        id:
          type: string
          format: uuid
        airline:
          type: string
        flightNumber:
          type: string
        origin:
          $ref: "#/components/schemas/Airport"
        destination:
          $ref: "#/components/schemas/Airport"
        departureTime:
          type: string
          format: date-time
        arrivalTime:
          type: string
          format: date-time
        durationMinutes:
          type: integer
          minimum: 0
        aircraft:
          type: string
        seatsAvailable:
          type: integer
      required:
        - id
        - airline
        - flightNumber
        - origin
        - destination
        - departureTime
        - arrivalTime
      example:
        id: f7d5d7c8-9b3e-4a0e-93e0-3bb08f75df0f
        airline: Example Air
        flightNumber: EA123
        origin:
          code: DEN
          name: Denver International Airport
          city: Denver
          country: USA
        destination:
          code: LAX
          name: Los Angeles International Airport
          city: Los Angeles
          country: USA
        departureTime: 2025-06-01T08:00:00Z
        arrivalTime: 2025-06-01T10:00:00Z
        durationMinutes: 120
        aircraft: Boeing 737
        seatsAvailable: 42
    Airport:
      type: object
      properties:
        code:
          $ref: "#/components/schemas/IATACode"
        name:
          type: string
        city:
          type: string
        country:
          type: string
    IATACode:
      type: string
      pattern: ^[A-Z]{3}$
      description: IATA airport code
      examples:
        - DEN
    FlightSearchResponse:
      type: object
      properties:
        flights:
          type: array
          items:
            $ref: "#/components/schemas/Flight"
        pagination:
          type: object
          properties:
            limit:
              type: integer
            offset:
              type: integer
            total:
              type: integer
      required:
        - flights
```