> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flyskye.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search flights

> One way, round trip and multi city, with live fares. Scope `search`. Send `origin`, `destination` and `departDate` for one way, add `returnDate` for a round trip, or send `legs` for multi city.



## OpenAPI

````yaml /api-reference/openapi.yaml post /search
openapi: 3.1.0
info:
  title: Skye Flights API
  version: '1.0'
  description: Search and book real flights for your users. Skye is the Merchant of Record.
servers:
  - url: https://api.flyskye.ai/v1
security:
  - accessToken: []
tags:
  - name: Authentication
  - name: Flights
  - name: Booking sessions
  - name: Payments
  - name: Bookings
paths:
  /search:
    post:
      tags:
        - Flights
      summary: Search flights
      description: >-
        One way, round trip and multi city, with live fares. Scope `search`.
        Send `origin`, `destination` and `departDate` for one way, add
        `returnDate` for a round trip, or send `legs` for multi city.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
            example:
              origin: BLR
              destination: DEL
              departDate: '2026-12-24'
              adults: 1
      responses:
        '200':
          description: Offers, cheapest first.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '502':
          $ref: '#/components/responses/Upstream'
components:
  schemas:
    SearchRequest:
      type: object
      properties:
        origin:
          type: string
          description: 3 letter IATA airport code. Not needed with `legs`.
          example: BLR
        destination:
          type: string
          description: 3 letter IATA code, different from origin.
          example: DEL
        departDate:
          type: string
          format: date
          description: Today or later.
        returnDate:
          type: string
          format: date
          description: After departDate. Makes it a round trip.
        legs:
          type: array
          minItems: 2
          maxItems: 8
          description: Multi city legs, in date order. Overrides the fields above.
          items:
            $ref: '#/components/schemas/Leg'
        adults:
          type: integer
          minimum: 1
          maximum: 9
          default: 1
        children:
          type: integer
          minimum: 0
          maximum: 8
          default: 0
        childAges:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 17
          description: Age of each child.
        infants:
          type: integer
          minimum: 0
          maximum: 8
          default: 0
          description: Lap infants
          never more than adults.: null
        cabinClass:
          type: string
          enum:
            - economy
            - premium_economy
            - business
            - first
          default: economy
        fareType:
          type: string
          enum:
            - regular
            - student
            - senior
          default: regular
          description: >-
            Student and senior citizen fares; the traveller may need ID at the
            airport.
        maxConnections:
          type: integer
          minimum: 0
          maximum: 2
          default: 1
          description: 0 for nonstop only.
        limit:
          type: integer
          minimum: 1
          maximum: 50
          default: 20
        mock:
          type: boolean
          default: false
          description: Return dummy offers on any key.
    SearchResponse:
      type: object
      properties:
        mode:
          type: string
          enum:
            - live
            - test
        mock:
          type: boolean
        query:
          type: object
          description: The search as Skye understood it, including `tripType`.
        count:
          type: integer
        offers:
          type: array
          items:
            $ref: '#/components/schemas/Offer'
    Leg:
      type: object
      required:
        - origin
        - destination
        - departDate
      properties:
        origin:
          type: string
          example: DEL
        destination:
          type: string
          example: BKK
        departDate:
          type: string
          format: date
    Offer:
      type: object
      properties:
        offerId:
          type: string
          example: off_...
        price:
          type: object
          description: The airline fare including taxes.
          properties:
            amount:
              type: string
              example: '6412'
            currency:
              type: string
              example: INR
        outbound:
          $ref: '#/components/schemas/Slice'
        return:
          description: Set on round trips.
          oneOf:
            - $ref: '#/components/schemas/Slice'
            - type: 'null'
        legs:
          description: Every leg, on multi city trips.
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/Slice'
        refundable:
          type:
            - boolean
            - 'null'
        changeable:
          type:
            - boolean
            - 'null'
        fareBrand:
          type:
            - string
            - 'null'
          example: Saver
        baggage:
          description: >-
            The allowance per traveller, as the airline states it. Null when not
            given.
          type:
            - object
            - 'null'
          properties:
            checkIn:
              type:
                - string
                - 'null'
              example: 15 Kg
            cabin:
              type:
                - string
                - 'null'
              example: 7 Kg
        expiresAt:
          type: string
          format: date-time
          description: Search again after this time.
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: invalid_request
            message:
              type: string
              example: departDate cannot be in the past
            field:
              type: string
              example: departDate
    Slice:
      type: object
      properties:
        airline:
          type: string
          example: IndiGo
        airlineCode:
          type: string
          example: 6E
        airlineLogo:
          type: string
        departTime:
          type: string
          description: Local to the airport.
          example: 2026-12-24T22:25
        arriveTime:
          type: string
          description: Local to the airport.
          example: 2026-12-25T01:20
        duration:
          type: string
          example: 2h 55m
        stops:
          type: integer
          example: 0
        layovers:
          type: array
          items:
            type: object
  responses:
    BadRequest:
      description: '`invalid_json`, `invalid_request` or `traveller_count`.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing, invalid or expired key or token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The key lacks the scope, or the resource belongs to another partner.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Upstream:
      description: Temporarily unavailable. Retry.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    accessToken:
      type: http
      scheme: bearer
      description: An access token (`sat_...`) from `POST /token`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.