Skip to main content
GET
/
connect
/
v1
/
connections
/
{connectionId}
/
cruises
/
{cruiseId}
Get a cruise on a connection
curl --request GET \
  --url https://api.voyant.travel/connect/v1/connections/{connectionId}/cruises/{cruiseId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "connectionId": "<string>",
  "externalId": "<string>",
  "name": "<string>",
  "cruiseType": "<string>",
  "nights": 123,
  "locale": "<string>",
  "supplierName": "<string>",
  "cruiseLineExternalId": "<string>",
  "shipExternalId": "<string>",
  "slug": "<string>",
  "status": "<string>",
  "destinations": [
    "<string>"
  ],
  "embarkationPortCode": "<string>",
  "disembarkationPortCode": "<string>",
  "market": "<string>",
  "currency": "<string>",
  "priceFromAmountMinor": 123,
  "priceFromCurrency": "<string>",
  "sourceKind": "<string>",
  "sourceProvider": "<string>",
  "sourceConnectionId": "<string>",
  "sourceRef": "<string>",
  "sourceFreshness": "<string>",
  "lastSourcedAt": "2023-11-07T05:31:56Z",
  "projection": {},
  "projectionSchemaVersion": "<string>",
  "projectionEtag": "<string>",
  "projectionSeenAt": "2023-11-07T05:31:56Z",
  "payload": {},
  "lastSyncedAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "providerKey": "<string>"
}

Authorizations

​
Authorization
string
header
required

Provide either a static platform API key or an OAuth2 access token (from /connect/v1/oauth/token) as Authorization: Bearer <token>. Scopes are connect:* (e.g. connect:bookings:write).

Path Parameters

​
connectionId
string
required

Connection id.

​
cruiseId
string
required

Response

200 - application/json

Cruise.

Connect-normalized cruise row. Carries provenance and the catalog projection.

​
id
string
required
​
connectionId
string
required
​
externalId
string
required
​
name
string
required
​
cruiseType
string
required
​
nights
integer
required
​
locale
string
required
​
supplierName
string
required
​
cruiseLineExternalId
string
​
shipExternalId
string
​
slug
string | null
​
status
string | null
​
destinations
string[] | null
​
embarkationPortCode
string | null
​
disembarkationPortCode
string | null
​
market
string | null
​
currency
string | null
​
priceFromAmountMinor
integer | null

Price-from in integer minor units.

​
priceFromCurrency
string | null
​
sourceKind
string | null
​
sourceProvider
string | null
​
sourceConnectionId
string | null
​
sourceRef
string | null

Provenance: upstream source reference.

​
sourceFreshness
string | null
​
lastSourcedAt
string<date-time> | null

Provenance: when the source row was last fetched.

​
projection
object

Canonical catalog projection to index downstream.

​
projectionSchemaVersion
string | null
​
projectionEtag
string | null
​
projectionSeenAt
string<date-time> | null
​
payload
object
​
lastSyncedAt
string<date-time>
​
updatedAt
string<date-time>
​
providerKey
string | null