---
title: "Search"
method: GET
path: "/flights-api/availability"
tags: ["Flights"]
---

# Search

`GET /flights-api/availability`

## Query parameters

- `site` string, required
- `from` string, required
- `to` string, required
- `departure_date` string, date, required
- `return_date` string, date
- `adults` integer, required
- `children` integer
- `infants` integer
- `currency` string
- `cabin_type` 'Business' | 'Firstclass' | 'Premium_business' | 'Premium_firstclass' | 'Premium_economy' | 'Economy'
- `offset` integer
- `limit` integer
- `group_by` string
- `order_by` string
- `price` string
- `total_price_range` string
- `stops` string
- `airlines` string
- `alliances` string
- `outbound_time_range` string
- `inbound_time_range` string
- `unique_airline` string
- `unique_outbound_airport` string
- `outbound_duration_range` string
- `inbound_duration_range` string
- `outbound_airports` string
- `inbound_airports` string
- `outbound_arrival_time_range` string

## Response `200`

OK

- object
  - `items` object[]
    - `id` string — ID automatically generated to identify the data sent in the search request.
    - `outbound_choices` object[] — This structure is a list and may return one or several outbound flight options.
      - `choice` integer
      - `duration` string, time
      - `segments` object[]
        - `from` string
        - `to` string
        - `departure_datetime` string, date-time
        - `arrival_datetime` string, date-time
        - `duration` string, time
        - `airline` string — IATA code of the marketing carrier (the airline selling the flight). This value always corresponds to a standard 2-letter IATA airline code and represents the airline under which the ticket is issued, regardless of which airline operates the flight.
        - `operated_by` string — IATA code of the operating carrier, i.e. the airline that physically operates the flight segment. This field is typically present in codeshare scenarios or airline groups with multiple operating certificates. When provided, it indicates the actual operator of the flight, not a list of airline affiliations.
        - `flight_id` string — Flight number
        - `cabin_type` string — Indicates the cabin class in which the flight segment is booked.
        - `stopovers` unknown[]
          - unknown
        - `seats_remaining` integer
        - `equipment_code` integer
        - `ancillary` object
          - `baggages_info` object
            - `baggages` object[]
              - …
          - `meals` unknown[]
            - unknown
          - `entertainments` unknown[]
            - unknown
        - `booking_class` string
      - `baggage` object
        - `adult` object
          - `quantity` integer
          - `carry_on` boolean
          - `personal_item` boolean
    - `price_detail` object
      - `currency` string
      - `total` integer
      - `base` integer — total base amount, summing the base fares for adult, child, and infant.
      - `adult_base` integer — base amount for an adult.
      - `adult_total` integer — total amount per adult.
      - `adults_subtotal` integer — total sum for adults.
      - `charges` integer — total amount of taxes and fees.
      - `net_fare` object — this item returns the fields 'applied' (indicates whether the fare is available) and 'reference_price' (the fare amount when available).
        - `applied` boolean
        - `reference_price` number
    - `validating_carrier` string — identifies the airline that will issue the ticket.
    - `booking_info` object[] — this structure is a list and may return one or several booking options; the number of items returned varies with the number of flight options returned.
      - `outbound_choice` integer
      - `itinerary_id` string
      - `choice_id` string
      - `fare_basis_codes` unknown[]
        - unknown
      - `upselling_available` boolean — Indicates whether the selected option supports upselling. A value of true does not guarantee the availability of upsell products, as availability is validated in real time by the Upselling service.
      - `fare_family` string
      - `search_reason` string
      - `country` string
      - `fare_restricted_to` string
      - `flexible_policies` unknown[]
        - unknown
      - `booking_reservation` object[]
        - `available` boolean
      - `alternatives_key` string
      - `public_parity_applied` boolean
    - `passenger_distribution` object
      - `adults` integer
      - `children` integer
      - `infants` integer
    - `last_minute` boolean
    - `tags` unknown[]
      - unknown
    - `route_type` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — FORBIDDEN
- `429` — RATE_LIMIT_EXCEEDED
- `500` — Internal Server Error
- `503` — FLIGHT_PROVIDER_ERROR

---

[API](https://skmtc.net/despegar/apis/decolar-booking-api.md) · [All operations](https://skmtc.net/despegar/apis/decolar-booking-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/despegar/decolar-booking-api/revisions/2fb15f2434ea/schema)