Create a guest cruise reservation
post
/spms/v2/ships/{shipId}/reservations/guests
This is to create a guest cruise reservation
Request
Supported Media Types
- application/json
Path Parameters
-
shipId(required): number
Ship Id
Guest Reservation Post Object
Root Schema : guestReservationPOSTObject
Type:
objectGuest Reservation POST Object
Show Source
-
boardCardNumber:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Board Card NumberExample:100500333 -
bookingNumber:
string
Minimum Length:
1Pattern:^[a-zA-Z0-9]+$Booking NumberExample:123456789 -
discountTemplateCode:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Discount Template CodeExample:A1 -
disembarkationDate:
string(date)
Disembarkation DateExample:
2018-11-11 -
disembarkationHarborCode:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Disembarkation Harbor CodeExample:D1 -
disembarkationHarborComments:
string
commentsExample:
Going to the land -
document:
object document
Document
-
embarkationDate(required):
string(date)
Embarkation DateExample:
2018-11-11 -
embarkationHarborCode:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Embarkation Harbor CodeExample:E1 -
embarkationHarborComments:
string
commentsExample:
Going to the sea -
isNoticeAndConsent(required):
boolean
Acknowledge Notice and ConsentExample:
true -
lifeBoatCode:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Lifeboat CodeExample:L1 -
manifestPrintout:
boolean
Manifest PrintoutExample:
false -
musterStationCode:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 ]*$Musterstation CodeExample:M1 -
numberOfCruiseDays:
number
Pattern:
^[0-9]*$Total Number Of Cruise DaysExample:1 -
numberOfCruises:
number
Pattern:
^[0-9]*$Number Of CruisesExample:1 -
onboardEmail:
string
Minimum Length:
1Maximum Length:49Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$Onboard Email Address * `null` if emptyExample:oneworld@gmail.com -
onboardStatus:
boolean
onboardStatusExample:
false -
otherParameter:
object otherParameter
Other Parameters
-
profileInformation:
object profileInformationPOST
Profile Information for Post
-
queueId:
number
Pattern:
^[0-9]*$Queue IdExample:11 -
setSailPassNumber:
string
Pattern:
^[ A-Za-z0-9,'_@./#&+-]*$Set Sail Pass NumberExample:3388 -
shoreGId:
string
Minimum Length:
1Maximum Length:50Pattern:^[a-zA-Z0-9 ]*$Shore G IdExample:G1 -
shoreResId:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Shore Reservation IdExample:S1 -
stateroomNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9- ]*$stateroomNumberExample:1001
Nested Schema : document
Type:
objectDocument
Show Source
-
isDocumentChecked:
boolean
Document Is CheckedExample:
false -
isDocumentCollected:
boolean
Document Is CollectExample:
false
Nested Schema : otherParameter
Type:
objectOther Parameters
Show Source
-
isAirSeaOperator:
boolean
Is Air Sea OperatorExample:
false -
isChargeCheckedOutCalls:
boolean
Is Charge For Checked Out CallsExample:
false -
isCompleteOnlineForm:
boolean
Is Complete Online FormExample:
false -
isExpressCheckOut:
boolean
Is Express CheckoutExample:
false -
isGroupLeader:
boolean
Is Group LeaderExample:
false -
isKioskCheckInAllowed:
boolean
Is Kiosk Check In AllowedExample:
false -
isNonInclusiveGuestType:
boolean
Is Non Inclusive Guest TypeExample:
false -
isResident:
boolean
Is ResidentExample:
false -
isStayOvernightTour:
boolean
Is Stay Overnight TourExample:
false -
isSwitchToCrewManifest:
boolean
Is Switch To Crew ManifestExample:
false
Nested Schema : profileInformationPOST
Type:
objectProfile Information for Post
Show Source
-
birthPlace:
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Birth PlaceExample:Kajang -
dateOfBirth(required):
string(date)
Birth DateExample:
2018-11-11 -
firstName(required):
string
Minimum Length:
1Maximum Length:40The first name of the guestExample:Kobe -
genderCode(required):
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 ]+?$Gender CodeExample:M -
guestCategoryCodes:
array guestCategoryPOST
-
lastName(required):
string
Minimum Length:
1Maximum Length:40The last name of the guestExample:James -
maritalStatusCode:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Marital Status CodeExample:S -
middleName:
string
Minimum Length:
1Maximum Length:20The middle name of the guestExample:Bean -
nationalId:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 ]*$National IdExample:22 -
nationalityCode(required):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Nationality CodeExample:MY -
otherFirstName:
string
Minimum Length:
1Maximum Length:80Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$Other First Name * `null` if emptyExample:Frost -
otherLastName:
string
Minimum Length:
1Maximum Length:100Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$Other Last Name * `null` if emptyExample:Francis -
passportIssuedCountryCode(required):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Passport Issued Country CodeExample:MY -
passportIssuedDate(required):
string(date)
Passport Issued DateExample:
2018-11-11 -
passportIssuedExpiryDate(required):
string(date)
Passport Issued Expiry DateExample:
2018-11-11 -
passportIssuedPlace(required):
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Passport Issued PlaceExample:Shah Alam -
passportNumber(required):
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 ]+?$Passport NumberExample:A145611 -
permanentResidentId:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Permanent ResidentExample:P123 -
royaltyNumber:
string
Maximum Length:
20Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Royalty NumberExample:a1234 -
salutation:
string
Minimum Length:
1Maximum Length:20The salutation of the guestExample:Mr. -
title:
string
Minimum Length:
1Maximum Length:20Pattern:^[ A-Za-z0-9,'_@./#&+-]*$TitleExample:MR -
vipCode:
string
Maximum Length:
6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$VIP CodeExample:L1
Nested Schema : guestCategoryPOST
Type:
Show Source
array-
Array of:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Guest Category CodesExample:GC1
Response
Supported Media Types
- application/json
201 Response
Created
Root Schema : guestReservationGETObject
Type:
objectGuest Reservation GET Object
Show Source
-
boardCardNumber:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Board Card NumberExample:100500333 -
bookingNumber:
string
Minimum Length:
1Pattern:^[a-zA-Z0-9]+$Booking NumberExample:123456789 -
discountTemplate:
object discountTemplate
Discount Template
-
disembarkationDate:
string(date)
Disembarkation DateExample:
2018-11-11 -
disembarkationHarbor:
object disembarkationHarbor
disembarkationHarbor
-
disembarkationHarborComments:
string
commentsExample:
Going to the land -
document:
object document
Document
-
embarkationDate:
string(date)
Embarkation DateExample:
2018-11-11 -
embarkationHarbor:
object embarkationHarbor
Embarkation Harbor
-
embarkationHarborComments:
string
commentsExample:
Going to the sea -
isNoticeAndConsent:
boolean
Acknowledge Notice and ConsentExample:
true -
lifeBoat:
object lifeBoat
Life Boat
-
manifestPrintout:
boolean
Manifest PrintoutExample:
false -
musterStation:
object musterStation
musterStation
-
numberOfCruiseDays:
number
Pattern:
^[0-9]*$Total Number Of Cruise DaysExample:1 -
numberOfCruises:
number
Pattern:
^[0-9]*$Number Of CruisesExample:1 -
onboardEmail:
string
Minimum Length:
1Maximum Length:49Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$Onboard Email Address * `null` if emptyExample:oneworld@gmail.com -
onboardStatus:
boolean
onboardStatusExample:
false -
otherParameter:
object otherParameter
Other Parameters
-
profileInformation:
object profileInformation
Profile Information
-
queueId:
number
Pattern:
^[0-9]*$Queue IdExample:11 -
reservationId:
number
Minimum Value:
1Pattern:^[0-9]*$Reservation IdExample:123 -
reservationStatus:
string
Reservation Status, RR=Reservation, RX=Cancelled, RE=Embark today, RN=No Show, CC=Checked In, CL=Leaving today, DD=DisembarkedExample:
CC -
setSailPassNumber:
string
Pattern:
^[ A-Za-z0-9,'_@./#&+-]*$Set Sail Pass NumberExample:3388 -
shoreGId:
string
Minimum Length:
1Maximum Length:50Pattern:^[a-zA-Z0-9 ]*$Shore G IdExample:G1 -
shoreResId:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Shore Reservation IdExample:S1 -
stateroomNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9- ]*$stateroomNumberExample:1001
Nested Schema : discountTemplate
Type:
objectDiscount Template
Show Source
-
code:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Discount Template CodeExample:A1 -
description:
string
Discount Template DescriptionExample:
Loyal Guest
Nested Schema : disembarkationHarbor
Type:
objectdisembarkationHarbor
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Disembarkation Harbor CodeExample:D1 -
description:
string
Disembarkation Harbor Code DescriptionExample:
To Land
Nested Schema : document
Type:
objectDocument
Show Source
-
isDocumentChecked:
boolean
Document Is CheckedExample:
false -
isDocumentCollected:
boolean
Document Is CollectExample:
false
Nested Schema : embarkationHarbor
Type:
objectEmbarkation Harbor
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Embarkation Harbor CodeExample:E1 -
description:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Embarkation Harbor Code DescriptionExample:To Sea
Nested Schema : lifeBoat
Type:
objectLife Boat
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Lifeboat CodeExample:L1 -
description:
string
Lifeboat Code DescriptionExample:
Guest Boat A
Nested Schema : musterStation
Type:
objectmusterStation
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 ]*$Musterstation CodeExample:M1 -
description:
string
Musterstation Code DescriptionExample:
Guest Deck 1
Nested Schema : otherParameter
Type:
objectOther Parameters
Show Source
-
isAirSeaOperator:
boolean
Is Air Sea OperatorExample:
false -
isChargeCheckedOutCalls:
boolean
Is Charge For Checked Out CallsExample:
false -
isCompleteOnlineForm:
boolean
Is Complete Online FormExample:
false -
isExpressCheckOut:
boolean
Is Express CheckoutExample:
false -
isGroupLeader:
boolean
Is Group LeaderExample:
false -
isKioskCheckInAllowed:
boolean
Is Kiosk Check In AllowedExample:
false -
isNonInclusiveGuestType:
boolean
Is Non Inclusive Guest TypeExample:
false -
isResident:
boolean
Is ResidentExample:
false -
isStayOvernightTour:
boolean
Is Stay Overnight TourExample:
false -
isSwitchToCrewManifest:
boolean
Is Switch To Crew ManifestExample:
false
Nested Schema : profileInformation
Type:
objectProfile Information
Show Source
-
birthPlace:
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Birth PlaceExample:Kajang -
dateOfBirth:
string(date)
Birth DateExample:
2018-11-11 -
firstName:
string
Minimum Length:
1Maximum Length:40The first name of the guestExample:Kobe -
gender:
object gender
Gender
-
guestCategories:
array guestCategory
-
lastName:
string
Minimum Length:
1Maximum Length:40The last name of the guestExample:James -
maritalStatus:
object maritalStatus
Marital Status
-
middleName:
string
Minimum Length:
1Maximum Length:20The middle name of the guestExample:Bean -
nationalId:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 ]*$National IdExample:22 -
nationality:
object nationalityStruct
Nationality
-
otherFirstName:
string
Minimum Length:
1Maximum Length:80Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$Other First Name * `null` if emptyExample:Frost -
otherLastName:
string
Minimum Length:
1Maximum Length:100Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$Other Last Name * `null` if emptyExample:Francis -
passportIssuedCountry:
object passportIssuedCountry
Passport Issued Country
-
passportIssuedDate:
string(date)
Passport Issued DateExample:
2018-11-11 -
passportIssuedExpiryDate:
string(date)
Passport Issued Expiry DateExample:
2018-11-11 -
passportIssuedPlace:
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Passport Issued PlaceExample:Shah Alam -
passportNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 ]+?$Passport NumberExample:A145611 -
permanentResidentId:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Permanent ResidentExample:P123 -
profileId:
number
Minimum Length:
1Pattern:^[0-9]*$Profile IdExample:12345 -
royaltyNumber:
string
Maximum Length:
20Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Royalty NumberExample:a1234 -
salutation:
string
Minimum Length:
1Maximum Length:20The salutation of the guestExample:Mr. -
title:
string
Minimum Length:
1Maximum Length:20Pattern:^[ A-Za-z0-9,'_@./#&+-]*$TitleExample:MR -
vip:
object vip
VIP
Nested Schema : gender
Type:
objectGender
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 ]+?$Gender CodeExample:M -
description:
string
Gender Code DescriptionExample:
Male
Nested Schema : guestCategory
Type:
Show Source
array-
Array of:
object guestCategoryGroup
Guest Category Group
Nested Schema : maritalStatus
Type:
objectMarital Status
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Marital Status CodeExample:S -
description:
string
Marital Status DescriptionExample:
Single
Nested Schema : nationalityStruct
Type:
objectNationality
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Nationality CodeExample:MY -
description:
string
Nationality Code DescriptionExample:
Malaysia
Nested Schema : passportIssuedCountry
Type:
objectPassport Issued Country
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Passport Issued Country CodeExample:MY -
description:
string
Passport Issued Country Code DescriptionExample:
Malaysia
Nested Schema : vip
Type:
objectVIP
Show Source
-
code:
string
Maximum Length:
6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$VIP CodeExample:L1 -
description:
string
VIP Code DescriptionExample:
Minister
Nested Schema : guestCategoryGroup
Type:
objectGuest Category Group
Show Source
-
code:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Guest Category CodesExample:GC1 -
description:
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]Guest Category Codes DescriptionExample:Couple
400 Response
Bad Request
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Bad Request",
"detail":"Invalid parameter(s) passed in"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
401 Response
Unauthorized
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
403 Response
Forbidden
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
404 Response
Not Found
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
"title":"Not Found",
"detail":"Ship Id could not be found"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
405 Response
Method Not Supported
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
406 Response
Not Acceptable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
410 Response
Gone
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
415 Response
Invalid content
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
500 Response
Internal Server Error
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
501 Response
Not Implemented
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
503 Response
Service Unavailable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source