> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyantcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Departure Itinerary

> Fetch itinerary days for a departure, with optional segments and selectable options.

## Method

`GET` `/v1/products/{productIdOrSlug}/departures/{departureId}/itinerary`

You can also call the top-level form: `GET /v1/departures/{departureId}/itinerary?productId=prod_xxx`. Both return the same data; the nested route additionally supports product slugs. If no `include` is provided, the response contains days, segments, and options.

## Path Parameters

<ParamField path="productIdOrSlug" type="string">Product ID (`prod_...`) or slug.</ParamField>
<ParamField path="departureId" type="uuid">Departure ID.</ParamField>

## Query Parameters

<ParamField query="locale" type="string">Locale for translations (alias: <code>lang</code>).</ParamField>
<ParamField query="include" type="string">Comma-separated extras: `segments`, `options`. Defaults to all when omitted.</ParamField>

## Headers

<ParamField header="Authorization" type="string">Bearer token (e.g. <code>Authorization: Bearer YOUR\_API\_KEY</code>)</ParamField>

## Request Example

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.voyantcloud.com/v1/products/paris-city-break/departures/dep_456/itinerary?include=segments,options" \
    -H "Authorization: Bearer $VOYANT_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const res = await fetch(
    "https://api.voyantcloud.com/v1/products/prod_123/departures/dep_456/itinerary?locale=en&include=segments",
    { headers: { Authorization: `Bearer ${process.env.VOYANT_API_KEY}` } },
  )
  const itinerary = await res.json()
  ```

  ```python Python theme={null}
  import os, requests

  resp = requests.get(
    "https://api.voyantcloud.com/v1/products/prod_123/departures/dep_456/itinerary",
    params={"include": "segments,options"},
    headers={"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}"},
  )
  data = resp.json()
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "itinerary_id": "iti_001",
    "version_id": "itv_010",
    "days": [
      {
        "id": "day_1",
        "day_no": 1,
        "title": "Arrival in Athens",
        "description": "Check in and welcome dinner",
        "thumbnail_url": null,
        "thumbnail_asset_id": null,
        "segments": [
          {
            "id": "seg_1",
            "day_id": "day_1",
            "sort": 1,
            "title": "City tour",
            "description": "Guided walking tour",
            "place_id": "place_athens",
            "start_time": "09:00",
            "end_time": "12:00",
            "option_groups": [
              {
                "id": "grp_1",
                "activity_id": "seg_1",
                "type": "addon",
                "label": "Lunch add-on",
                "description": null,
                "min_selections": 0,
                "max_selections": 1,
                "is_required": false,
                "sort_index": 0,
                "options": [
                  {
                    "id": "opt_1",
                    "group_id": "grp_1",
                    "label": "Traditional taverna",
                    "description": "3-course meal",
                    "price_delta": 25,
                    "currency": "EUR",
                    "duration_minutes": 90,
                    "inventory_sku": null,
                    "capacity_per_slot": null,
                    "timeslot_rule_id": null,
                    "min_qty": 1,
                    "max_qty": 10,
                    "is_default": false,
                    "sort_index": 0
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>

<Note>When <code>include</code> is omitted the response only contains the ordered list of day cards. Add <code>segments</code> and <code>options</code> to hydrate booking flows with rich activity data.</Note>