---
title: "Search flights"
url: "https://kiwi.arashsheyda.me/apis/test/versions/9521eca2-d6a3-4036-a754-7b1bb1c91cdd/paths/flights/get"
---

> Full API specification: https://kiwi.arashsheyda.me/apis/test/versions/9521eca2-d6a3-4036-a754-7b1bb1c91cdd.md

# Search flights

`GET` `/flights`

Retrieve a list of available flights based on criteria.

## Query parameters

- `origin` (string, required)
- `destination` (string, required)
- `departure_date` (string, date, required)

## Responses

- `200` - A list of available flights

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Flight API
  version: 1.0.0
servers:
  - url: https://api.example.com/v1
paths:
  /flights:
    get:
      summary: Search flights
      description: Retrieve a list of available flights based on criteria.
      parameters:
        - name: origin
          in: query
          required: true
          schema:
            type: string
        - name: destination
          in: query
          required: true
          schema:
            type: string
        - name: departure_date
          in: query
          required: true
          schema:
            type: string
            format: date
      responses:
        "200":
          description: A list of available flights
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/Flight"
components:
  schemas:
    Flight:
      type: object
      properties:
        id:
          type: string
        airline:
          type: string
        flight_number:
          type: string
        origin:
          type: string
        destination:
          type: string
        departure_time:
          type: string
          format: date-time
        arrival_time:
          type: string
          format: date-time
        price:
          type: number
          format: float
```