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

productIdOrSlug · string

Product ID (prod_...) or product slug (required).

locale · string

Locale for meeting point translations (defaults to en).

limit · integer

Items per page (defaults to 100).

offset · integer

Number of items to skip (defaults to 0).

Headers

Authorization · string

Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)

Request Example

cURL

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"

Response

200 OK

{
  "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
  }
}