DEdespegar
Shopping

Shopping

Returns available modalities, pricing, and availability windows for a specific theme park product. Results include all available dates within the requested range, with cancellation policies and distribution details per availability.

get/shopping

Request

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

Query parameters

id'BG_ORL' | 'DY_ORL' | 'SW_ORL' | 'UN_ORL' required

Park product identifier. Only the following values are accepted: BG_ORL (Busch Gardens Orlando), DY_ORL (Disney Orlando), SW_ORL (SeaWorld Orlando), UN_ORL (Universal Orlando Resort). Sending any other value returns a 400 INVALID_FIELD error.

sitestring required

Country site used to determine currency and content localization. Uses ISO 3166-1 alpha-2 country codes (e.g. AR for Argentina, BR for Brazil).

languagestring required

Language for response content such as names, descriptions, and policies.

fromstring date required

Start date of the availability window. Format: YYYY-MM-DD. If to is omitted, the API returns availability for 7 days starting from this date (i.e. from through from + 6 days). Sending a blank value or an incorrect format returns a 400 INVALID_FIELD error.

tostring date

End date of the availability window. Format: YYYY-MM-DD. Must be greater than or equal to from. If omitted, defaults to from + 6 days. Sending an incorrect format returns a 400 INVALID_FIELD error.

distributionstring required

Passenger composition. Format: {adults} or {adults}-{child_age_1}-{child_age_2}.... Adults is a required integer. Each additional number represents the age of one child. Example: 2-5 means 2 adults and 1 child aged 5. 2-3-7 means 2 adults and 2 children aged 3 and 7.

modalitiesstring

Comma-separated list of modality IDs to filter results. If omitted, all available modalities for the park are returned. Each id is available in the response body under modalities[].id. If one or more modality IDs are invalid or unrecognized, the API returns only the valid ones without returning an error — invalid IDs are silently ignored.

Response

Successful response with park modalities and availability.

tracking_idstring

Park product identifier, matches the id query parameter sent in the request.

namestring

Display name of the park product.

descriptionstring

Full HTML-capable description of the park.

logostring

URL of the park logo image.

Example response

[
  {
    "tracking_id": "DY_ORL",
    "name": "Sample Park Name",
    "modalities": [
      {
        "modality_type": "Modality",
        "id": "ANNUAL-AK-2024",
        "duration": {
          "type": "DAY",
          "value": "1"
        },
        "availabilities": [
          {
            "choice_id": "eyJzYW1wbGUiOiJ0cnVlIn0=",
            "date": "2026-10-10",
            "price_details": [
              {
                "total": 100,
                "currency": "USD",
                "currency_to_usd_change_rate": 1,
                "usd_to_currency_change_rate": 1,
                "net": 95,
                "tax": 5,
                "gross": 100
              }
            ],
            "distribution": {
              "adults": 1,
              "adult_max_age": 120,
              "child_max_age": 9,
              "infant_max_age": 2
            },
            "cancellation_policy": {
              "title": "Free cancellation",
              "cancellable": true,
              "ranges": [
                {
                  "penalty": {
                    "USD": 0
                  }
                }
              ]
            },
            "ticket_validity": {
              "use_date": "2026-10-10",
              "use_expiration_date": "2026-10-10T23:59:59Z"
            }
          }
        ]
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.