Jump to

• Request
• Response

Retrieve guest record that having reservation from current and future cruise.

get

/spms/v2/ships/{shipId}/reservations/backToBackReservations

This is to retrieve listing of same guest that have reservation from current and future cruise.

Request

Supported Media Types

• application/json

Path Parameters

• shipId(required): number
  Ship Id

Query Parameters

• fromCruiseId(required): number
  Cruise itinerary ID (reservation from source cruise itinerary)
• orderBy: string
  Order by First Name and Last Name with format column1:asc/desc,column2:asc/desc

  Default Value: firstName:asc
• toCruiseId(required): number
  Cruise itinerary ID (reservation from destination cruise itinerary)

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : guestReservationResponse

Type: object

Title: guestReservationResponse

Guest Reservation Response

Show Source

• guestRecordListings: array guestRecordListings
• toCruiseDescription: string
  Cruise Itinerary Description (destination Cruise Itinerary)

  Example: Fjord Itinerary
• toCruiseId: number
  Cruise Itinerary ID (destination Cruise Itinerary)

  Example: 123
• toCruiseStartDate: string(ISO 8601 (YYYY-MM-DD))
  Cruise Start Date (destination Cruise start date)

  Example: 2025-04-19

{
    "title":"guestReservationResponse",
    "description":"Guest Reservation Response",
    "type":"object",
    "properties":{
        "toCruiseId":{
            "$ref":"#/definitions/toCruiseId"
        },
        "toCruiseDescription":{
            "$ref":"#/definitions/toCruiseDescription"
        },
        "toCruiseStartDate":{
            "$ref":"#/definitions/toCruiseStartDate"
        },
        "guestRecordListings":{
            "$ref":"#/definitions/guestRecordListings"
        }
    }
}

Nested Schema : guestRecordListings

Type: array

Show Source

• Array of: object guestRecord
  Guest Record

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/guestRecord"
    }
}

Nested Schema : guestRecord

Type: object

Guest Record

Show Source

• accountCategory: string
  Allowed Values: [ "PAX" ]

  accountCategory

  Example: PAX
• dateOfBirth: string(date)
  Birth Date

  Example: 2018-11-11
• discountTemplate: object discountTemplate
  Discount Template
• disembarkationDate: string(date)
  Disembarkation Date

  Example: 2018-11-11
• email: string
  Email

  Example: [e-mail]
• embarkationDate: string(date)
  Embarkation Date

  Example: 2018-11-11
• firstName: string
  Minimum Length: 1

  Maximum Length: 40

  The first name of the guest

  Example: Kobe
• fromReservationId: number
  Reservation ID (source reservation ID)

  Example: 12345
• gender: object gender
  Gender
• lastName: string
  Minimum Length: 1

  Maximum Length: 40

  The last name of the guest

  Example: James
• middleName: string
  Minimum Length: 1

  Maximum Length: 20

  The middle name of the guest

  Example: Bean
• mobileNumber: string
  Minimum Length: 1

  Maximum Length: 30

  Pattern: ^[0-9+-]*$

  Mobile Number * `null` if empty

  Example: 62-39629630
• nationality: object nationalityStruct
  Nationality
• otherFirstName: string
  Minimum Length: 1

  Maximum Length: 80

  Pattern: ^[ a-zA-Z0-9_.À-῿Ⰰ-퟿]*$

  Other First Name * `null` if empty

  Example: Frost
• otherLastName: string
  Minimum Length: 1

  Maximum Length: 100

  Pattern: ^[ a-zA-Z0-9_.À-῿Ⰰ-퟿]*$

  Other Last Name * `null` if empty

  Example: Francis
• passportExpiryDate: string(ISO 8601)
  Passport Expiry Date

  Example: 2009-10-31
• passportNumber: string
  Minimum Length: 1

  Maximum Length: 20

  Pattern: ^[a-zA-Z0-9 ]+?$

  Passport Number

  Example: A145611
• photo: string
  Photo

  Example: /9j/4AAQSkZJRgABAQEASABIAAD==
• reservationExternalId: string
  Reservation External ID

  Example: 132789
• reservationExternalReferenceId: string
  Reservation External Reference ID

  Example: D132789
• salutation: string
  Minimum Length: 1

  Maximum Length: 20

  The salutation of the guest

  Example: Mr.
• stateroomNumber: string
  Minimum Length: 1

  Maximum Length: 20

  Pattern: ^[a-zA-Z0-9- ]*$

  stateroomNumber

  Example: 1001
• title: string
  Minimum Length: 1

  Maximum Length: 20

  Pattern: ^[ A-Za-z0-9,'_@./#&+-]*$

  Title

  Example: MR
• toReservationId: number
  Reservation ID (destination reservation ID)

  Example: 54321

{
    "description":"Guest Record",
    "type":"object",
    "properties":{
        "fromReservationId":{
            "$ref":"#/definitions/fromReservationId"
        },
        "toReservationId":{
            "$ref":"#/definitions/toReservationId"
        },
        "photo":{
            "$ref":"#/definitions/photo"
        },
        "firstName":{
            "$ref":"#/definitions/firstName"
        },
        "lastName":{
            "$ref":"#/definitions/lastName"
        },
        "middleName":{
            "$ref":"#/definitions/middleName"
        },
        "otherFirstName":{
            "$ref":"#/definitions/otherFirstName"
        },
        "otherLastName":{
            "$ref":"#/definitions/otherLastName"
        },
        "salutation":{
            "$ref":"#/definitions/salutation"
        },
        "title":{
            "$ref":"#/definitions/title"
        },
        "gender":{
            "$ref":"#/definitions/gender"
        },
        "dateOfBirth":{
            "$ref":"#/definitions/dateOfBirth"
        },
        "nationality":{
            "$ref":"#/definitions/nationalityStruct"
        },
        "email":{
            "$ref":"#/definitions/email"
        },
        "mobileNumber":{
            "$ref":"#/definitions/mobileNumber"
        },
        "accountCategory":{
            "$ref":"#/definitions/accountCategory"
        },
        "discountTemplate":{
            "$ref":"#/definitions/discountTemplate"
        },
        "passportNumber":{
            "$ref":"#/definitions/passportNumber"
        },
        "passportExpiryDate":{
            "$ref":"#/definitions/passportExpiryDate"
        },
        "stateroomNumber":{
            "$ref":"#/definitions/stateroomNumber"
        },
        "embarkationDate":{
            "$ref":"#/definitions/embarkationDate"
        },
        "disembarkationDate":{
            "$ref":"#/definitions/disembarkationDate"
        },
        "reservationExternalId":{
            "$ref":"#/definitions/reservationExternalId"
        },
        "reservationExternalReferenceId":{
            "$ref":"#/definitions/reservationExternalReferenceId"
        }
    }
}

Nested Schema : discountTemplate

Type: object

Discount Template

Show Source

• code: string
  Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]

  Discount Template Code

  Example: A1
• description: string
  Discount Template Description

  Example: Loyal Guest

{
    "description":"Discount Template",
    "type":"object",
    "properties":{
        "code":{
            "$ref":"#/definitions/discountTemplateCode"
        },
        "description":{
            "$ref":"#/definitions/discountTemplateDescription"
        }
    }
}

Nested Schema : gender

Type: object

Gender

Show Source

• code: string
  Minimum Length: 1

  Maximum Length: 6

  Pattern: ^[a-zA-Z0-9 ]+?$

  Gender Code

  Example: M
• description: string
  Gender Code Description

  Example: Male

{
    "description":"Gender",
    "type":"object",
    "properties":{
        "code":{
            "$ref":"#/definitions/genderCode"
        },
        "description":{
            "$ref":"#/definitions/genderCodeDescription"
        }
    }
}

Nested Schema : nationalityStruct

Type: object

Nationality

Show Source

• code: string
  Minimum Length: 1

  Maximum Length: 6

  Pattern: ^[ A-Za-z0-9,'_@./#&+-]*$

  Nationality Code

  Example: MY
• description: string
  Nationality Code Description

  Example: Malaysia

{
    "description":"Nationality",
    "type":"object",
    "properties":{
        "code":{
            "$ref":"#/definitions/nationalityCode"
        },
        "description":{
            "$ref":"#/definitions/nationalityCodeDescription"
        }
    }
}

204 Response

No Content

400 Response

Bad Request

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
        "title":"Bad Request",
        "detail":"The parameter 'shipId' has incorrect format"
    }
}

Example:

{
    "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Bad Request",
    "detail":"The parameter 'shipId' has incorrect format"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
        "title":"Unauthorized",
        "detail":"Valid token is required to access this resource"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
    "title":"Unauthorized",
    "detail":"Valid token is required to access this resource"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

403 Response

Forbidden

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
        "title":"Forbidden",
        "detail":"Access to this resource is forbidden"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
    "title":"Forbidden",
    "detail":"Access to this resource is forbidden"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

404 Response

Not Found

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
        "title":"Not Found",
        "detail":"HTTP 404 Not Found"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
    "title":"Not Found",
    "detail":"HTTP 404 Not Found"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

405 Response

Method Not Allowed

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
        "title":"Method Not Supported",
        "detail":"HTTP method not supported for this resource"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
    "title":"Method Not Supported",
    "detail":"HTTP method not supported for this resource"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

406 Response

Not Acceptable

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
        "title":"Not Acceptable",
        "detail":"Request a Mime type that is supported for this Resource"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
    "title":"Not Acceptable",
    "detail":"Request a Mime type that is supported for this Resource"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

410 Response

Gone

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.11",
        "title":"Gone",
        "detail":"Requested Resource no longer exists"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.11",
    "title":"Gone",
    "detail":"Requested Resource no longer exists"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

415 Response

Unsupported Media Type

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
        "title":"Invalid content",
        "detail":"Content type not supported"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
    "title":"Invalid content",
    "detail":"Content type not supported"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

500 Response

Internal Server Error

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
        "title":"Internal Server Error",
        "detail":"Issue fulfilling request. Please retry or contact support"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
    "title":"Internal Server Error",
    "detail":"Issue fulfilling request. Please retry or contact support"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

501 Response

Not Implemented

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.2",
        "title":"Not implemented",
        "detail":"Resource is not implemented in this version of the API"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.2",
    "title":"Not implemented",
    "detail":"Resource is not implemented in this version of the API"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

503 Response

Service Unavailable

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/guestReservationErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
        "title":"Service Unavailable",
        "detail":"Service not available"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
    "title":"Service Unavailable",
    "detail":"Service not available"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

Back to Top