---
title: "Alternatives Search"
method: GET
path: "/reservations/changes/alternatives"
tags: ["Changes"]
---

# Alternatives Search

`GET /reservations/changes/alternatives`

## Query parameters

- `transaction_id` string, required
- `departure_date` string
- `return_date` string
- `locale` 'pt_br' | 'en_us' | 'es_ar'
- `from` string
- `to` string
- `IATA` string

## Response `200`

OK

- object
  - `alternatives` object[]
    - `id` string
    - `outbound_choices` object[]
      - `duration_time` object
        - `hours` integer
        - `minutes` integer
      - `from_location` object
        - `airport` object
          - `code` string
          - `name` string
        - `city` object
          - `code` string
          - `name` string
        - `country` object
          - `code` string
          - `name` string
      - `to_location` object
        - `airport` object
          - `code` string
          - `name` string
        - `city` object
          - `code` string
          - `name` string
        - `country` object
          - `code` string
          - `name` string
      - `segments` object[]
        - `duration_time` object
          - `hours` integer
          - `minutes` integer
        - `from_location` object
          - `airport` object
            - `code` string
            - `name` string
          - `city` object
            - `code` string
            - `name` string
          - `country` object
            - `code` string
            - `name` string
        - `to_location` object
          - `airport` object
            - `code` string
            - `name` string
          - `city` object
            - `code` string
            - `name` string
          - `country` object
            - `code` string
            - `name` string
        - `departure_moment` string, date
        - `arrival_moment` string, date
        - `flight_number` integer
        - `marketing_carrier` object
          - `code` string
          - `name` string
        - `operating_carrier` object
          - `code` string
          - `name` string
    - `itinerary_type` string
    - `price_detail` object
      - `currency` string
      - `total` integer
      - `base` integer
      - `adult_base` integer
      - `adult_total` integer
      - `adults_subtotal` integer
      - `taxes` integer
      - `taxes_detail` object[]
        - `code` string
        - `amount` integer
      - `fees` integer
      - `penalty` integer
    - `validating_carrier` object
      - `code` string
      - `name` string
    - `passenger_distribution` object
      - `adults` integer
      - `children` integer
      - `infants` integer
    - `booking_info` object[]
      - `outbound_choice` integer
      - `changes_retrieve_resource_id` string — Code required to identify selected alternative in the next step (Checkout Context)
      - `search_id` string
      - `exchange_id` string

## Other responses

- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server 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)