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

# Availability

`GET /flights-api/availability`

## Request

- Base URL: `https://api-dev.despegar.com/v3`
- URL: `https://api-dev.despegar.com/v3/flights-api/availability`
- Auth: API key in header `x-apikey`

## 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` number: Flight option number.
      - `duration` string, time: Duration of the trip.
      - `segments` object[]
        - `from` string: Departure airport
        - `to` string: Arrival airport
        - `departure_datetime` string, date-time: Scheduled departure date and time.
        - `arrival_datetime` string, date-time: Scheduled arrival date and time.
        - `duration` string, time: Total trip duration.
        - `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[]: Contains information about each stopover in the itinerary
          - unknown
        - `seats_remaining` number
        - `equipment_code` string: Aircraft equipment code.
        - `ancillary` object: List of ancillary services available for the flight.
          - `baggages_info` object
            - `baggages` object[]
              - …
          - `meals` unknown[]
            - unknown
          - `entertainments` unknown[]
            - unknown
        - `booking_class` string
      - `baggage` object
        - `adult` object
          - `quantity` number
          - `carry_on` boolean
          - `personal_item` boolean
          - `weight` number: Maximum weight allowed for the baggage, expressed in the specified unit.
    - `price_detail` object
      - `currency` string
      - `total` number
      - `base` number: total base amount, summing the base fares for adult, child, and infant.
      - `adult_base` number: base amount for an adult.
      - `adult_total` number: total amount per adult.
      - `adults_subtotal` number: total sum for adults.
      - `charges` number: 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` number
      - `itinerary_id` string
      - `choice_id` string
      - `fare_basis_codes` string[]
      - `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: Name of the fare group associated with the product.
      - `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` number
      - `children` number
      - `infants` number
    - `last_minute` boolean
    - `tags` unknown[]
      - unknown
    - `route_type` string
  - `sorting` object
    - `criteria` string
    - `values` object[]
      - `value` string
      - `selected` boolean
  - `paging` object
    - `offset` number
    - `limit` number
    - `total` number
  - `facets` object[]
    - `criteria` string
    - `type` string
    - `subtype` string
    - `min` string
    - `max` string
    - `currency` 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.dev/despegar/apis/decolar-flights-api.md) - [All operations](https://skmtc.dev/despegar/apis/decolar-flights-api/llms.txt) - [OpenAPI document](https://skmtc.dev/despegar/apis/decolar-flights-api/revisions/ed39ac097726?raw)