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

# Availability

`GET /availability`

## Request

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

## Query parameters

- `id` string, required
- `modality` string, required
- `date` string, date, required
- `site` string, required
- `language` 'es' | 'pt' | 'en', required
- `additionals` string
- `distribution` string
- `schedule` number

## Response `200`

Successful response

- object
  - `choice_id` string: ID generated to identify the ticket data and the valid fare to make the reservation.
  - `name` string: Attraction name.
  - `modality_choice_name` string: Name of the chosen modality.
  - `type` string: Refers to the type of activity.
  - `language` string: Identifies the language.
  - `site` string: Country code identifying the site. E.g.: `BR`, `AR`.
  - `destination` string: IATA code identifying the destination. E.g.: `ORL`, `BUE`.
  - `from` string, date-time: Start date of the activity in ISO 8601 format.
  - `to` string, date-time: End date of the activity in ISO 8601 format.
  - `distribution` object
    - `adults` integer: Number of adults.
    - `adults_ages` unknown[]: Ages of the adults. May be empty.
      - unknown
    - `children_ages` unknown[]: Ages of the children. May be empty.
      - unknown
    - `infants_ages` unknown[]: Ages of the infants. May be empty.
      - unknown
    - `adult_max_age` number: Maximum age to be considered an adult.
    - `child_max_age` number: Maximum age to be considered a child.
    - `infant_max_age` number: Maximum age to be considered an infant.
  - `additions_chosen` object[]
    - `title` string
    - `description` string
    - `prices` object: This array contains the reservation prices by currency. USD is always included by default, and an additional local currency may be returned depending on the site.
  - `price_details` object[]
    - `total` number
    - `currency` string
    - `currency_to_usd_change_rate` number
    - `usd_to_currency_change_rate` number
    - `net` number
    - `tax` number
    - `gross` number
    - `price_disaggregation` object
      - `agency_commission` object
        - `gross` number
        - `net` number
        - `tax` number
  - `cancellation_policy` object
    - `title` string
    - `cancellable` boolean
    - `ranges` object[]
      - `from` string, date: Start of the cancellation range in ISO 8601 format.
      - `to` string, date: End of the cancellation range in ISO 8601 format. Not present for the last range (open-ended).
      - `penalty` object: Penalty amount per currency if cancelled within this range.
        - `USD` number
        - `BRL` number
      - `percentage` number: Penalty percentage applied in this range. `0.0` means free cancellation, `100.0` means no refund.
      - `label` string: Human-readable description of the cancellation rule in the requested language.
    - `conditions` unknown[]
      - unknown
  - `highlights` string[]: List of highlights or featured attractions included in the activity.
  - `ticket_validity` object: Validity period of the ticket. Not always present.
    - `use_date` string, date: Date on which the ticket must be used. Format: `YYYY-MM-DD`.
    - `use_expiration_date` string, date-time: Date and time at which the ticket expires. Format: ISO 8601.

## Other responses

- `400`: Bad Request. Returned when one or more request parameters are missing or invalid.
- `503`: Service Unavailable. Returned when the activity provider is unreachable or returns an error. Common causes include: no availability for the requested dates or distribution, or an invalid activity ID or modality.

---

[API](https://skmtc.dev/despegar/apis/activities.md) - [All operations](https://skmtc.dev/despegar/apis/activities/llms.txt) - [OpenAPI document](https://skmtc.dev/despegar/apis/activities/revisions/ba77a3fc2d00?raw)