> ## 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.

# List Departures

> Retrieve departures for a product with pagination and optional locale overrides.

## Method

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

You can also use the top-level form: `GET /v1/departures?productId=prod_xxx`. Both return the same data; the nested route additionally supports product slugs.

## Path & Query Parameters

<ParamField path="productIdOrSlug" type="string">Product ID (`prod_...`) or product slug (required).</ParamField>
<ParamField query="locale" type="string">Locale for meeting point translations (defaults to `en`).</ParamField>
<ParamField query="limit" type="integer">Items per page (defaults to 100).</ParamField>
<ParamField query="offset" type="integer">Number of items to skip (defaults to 0).</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/departures?productId=prod_123&limit=25" \
    -H "Authorization: Bearer $VOYANT_API_KEY"

  curl "https://api.voyantcloud.com/v1/products/paris-city-break/departures?limit=25&lang=fr" \
    -H "Authorization: Bearer $VOYANT_API_KEY"
  ```

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

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

  resp = requests.get(
    "https://api.voyantcloud.com/v1/products/prod_123/departures",
    params={"limit": 10, "offset": 0},
    headers={"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}"},
  )
  departures = resp.json()
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "dep_456",
        "start_at": "2025-03-10T08:00:00Z",
        "end_at": "2025-03-15T18:00:00Z",
        "capacity": 40,
        "status": "scheduled",
        "meeting_point": "Athens Port",
        "transport_mode_id": null,
        "transport_config_id": null,
        "itinerary_id": "iti_001",
        "ship_id": null,
        "attributes": {},
        "booked_pax": 0,
        "occupancy_pct": 0,
        "starting_price": { "total": 1299, "currency": "EUR" }
      }
    ],
    "meta": {
      "total": 12,
      "limit": 25,
      "offset": 0,
      "hasMore": false
    }
  }
  ```
</ResponseExample>