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

# Alternatives Search

`GET /reservations/changes/alternatives`

## Request

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

## 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.dev/despegar/apis/aftersale.md) - [All operations](https://skmtc.dev/despegar/apis/aftersale/llms.txt) - [OpenAPI document](https://skmtc.dev/despegar/apis/aftersale/revisions/686d705e3aa8?raw)