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: object accountCategoryStruct
  Account Category
• dateOfBirth: string(ISO 8601 (YYYY-MM-DD))
  Date Of Birth

  Example: 1999-02-15
• discountTemplate: object discountTemplate
  Discount Template
• disembarkationDate: string(ISO 8601 (YYYY-MM-DD))
  Dismbarkation Date

  Example: 2022-02-26
• email: string
  Email

  Example: [e-mail]
• embarkationDate: string(ISO 8601 (YYYY-MM-DD))
  Embarkation Date

  Example: 2022-02-25
• 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
  Mobile Number

  Example: 60112233445
• nationality: object nationalityStruct
  Nationality
• otherFirstName: string
  Minimum Length: 1

  Maximum Length: 40

  Pattern: [a-z]

  Other First Name

  Example: Frost
• otherLastName: string
  Minimum Length: 1

  Maximum Length: 40

  Pattern: [a-z]

  Other Last Name

  Example: Francis
• passportExpiryDate: string(ISO 8601 (YYYY-MM-DD))
  Passport Expiry Date

  Example: 2025-02-25
• passportNumber: string
  Passport Number

  Example: A1510202
• photo: string
  Photo

  Example: https://example.com/resources/guardian.jpg
• 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

  Pattern: ^[0-9]*$

  Stateroom Number

  Example: 1001
• title: string
  Title

  Example: Countess
• 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/accountCategoryStruct"
        },
        "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 : accountCategoryStruct

Type: object

Account Category

Show Source

• code: string
  Minimum Value: 1

  Maximum Value: 6

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

  Account Category code

  Example: PROLOS
• description: string
  Minimum Value: 1

  Maximum Value: 1000

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

  Account Category Description

  Example: Profit and Loss Account

{
    "description":"Account Category",
    "type":"object",
    "properties":{
        "code":{
            "$ref":"#/definitions/accountCategoryCode"
        },
        "description":{
            "$ref":"#/definitions/accountCategoryDescription"
        }
    }
}

Nested Schema : discountTemplate

Type: object

Discount Template

Show Source

• code: string
  Discount Template Code

  Example: LV2
• description: string
  Discount Template Description

  Example: Disc Template 2

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

Nested Schema : gender

Type: object

Gender

Show Source

• code: string
  Gender Code

  Example: F
• description: string
  Gender Name

  Example: Female

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

Nested Schema : nationalityStruct

Type: object

Nationality

Show Source

• code: string
  Country Code

  Example: US
• description: string
  Country Name * `null` if empty 'Country Name'

  Example: United States

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

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