Retrieve a guest reservation by Reservation Id
get
/spms/v2/ships/{shipId}/reservations/guests
This is to retrieve a guest cruise reservation by Reservation Id
Request
Supported Media Types
- application/json
Path Parameters
-
shipId: number
ship Id
Query Parameters
-
bookingNumber: string
Booking Number
-
disembarkationDateFrom: string(date)
Disembarkation Date From
-
disembarkationDateTo: string(date)
Disembarkation Date To
-
embarkationDateFrom: string(date)
Embarkation Date From
-
embarkationDateTo: string(date)
Embarkation Date To
-
limit: integer(int32)
Minimum Length:
1
Paging limitDefault Value:50
-
offset: integer(int32)
Minimum Length:
0
Paging offsetDefault Value:0
-
orderBy: string
order by embarkationDateFrom, disembarkationDateFrom, bookingNumber with format column1:asc/desc,column2:asc/desc
-
profileId: number
Profile Id
-
reservationId: number
Reservation Id
-
reservationStatus: string
Reservation Status
-
setSailPassNumber: string
Set Sail Pass Number
-
stateroomNumber: string
Stateroom Number
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : schema
Type:
Show Source
array
-
Array of:
object guestReservationGETObject
Guest Reservation GET Object
Nested Schema : guestReservationGETObject
Type:
object
Guest Reservation GET Object
Show Source
-
boardCardNumber(optional):
string
Minimum Length:
1
Maximum Length:20
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Boardcard number * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:A9800000000001
-
bookingNumber(optional):
string
Minimum Length:
1
Pattern:^[a-zA-Z0-9]+$
Booking NumberExample:123456789
-
discountTemplate(optional):
object discountTemplate
Discount Template
-
disembarkationDate(optional):
string
Reservation disembarkation date * `Optional` (Do not provide if not in use) * For all Profile TypesExample:
2021-01-30
-
disembarkationHarbor(optional):
object disembarkationHarbor
disembarkationHarbor
-
disembarkationHarborComments(optional):
string
commentsExample:
Going to the land
-
document(optional):
object document
Document
-
embarkationDate(optional):
string
Reservation embarkation date * `Optional` (Do not provide if not in use) * For all Profile TypesExample:
2021-01-26
-
embarkationHarbor(optional):
object embarkationHarbor
Embarkation Harbor
-
embarkationHarborComments(optional):
string
commentsExample:
Going to the sea
-
isNoticeAndConsent(optional):
boolean
Acknowledge Notice and ConsentExample:
true
-
lifeBoat(optional):
object lifeBoat
Life Boat
-
manifestPrintout(optional):
boolean
Manifest PrintoutExample:
false
-
musterStation(optional):
object musterStation
musterStation
-
numberOfCruiseDays(optional):
number
Pattern:
^[0-9]*$
Total Number Of Cruise DaysExample:1
-
numberOfCruises(optional):
number
Pattern:
^[0-9]*$
Number Of CruisesExample:1
-
onboardEmail(optional):
string
Minimum Length:
1
Maximum Length:49
Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$
Onboard Email Address * `null` if emptyExample:oneworld@gmail.com
-
onboardStatus(optional):
boolean
Onboard status * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:
true
-
otherParameter(optional):
object otherParameter
Other Parameters
-
profileInformation(optional):
object profileInformation
Profile Information
-
queueId(optional):
number
Pattern:
^[0-9]*$
Queue IdExample:11
-
reservationId(optional):
number
Minimum Value:
1
Pattern:^[0-9]*$
Reservation IdExample:1001
-
reservationStatus(optional):
string
Reservation Status, RR=Reservation, RX=Cancelled, RE=Embark today, RN=No Show, CC=Checked In, CL=Leaving today, DD=DisembarkedExample:
CC
-
setSailPassNumber(optional):
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]
Set Sail Pass NumberExample:3388
-
shoreGId(optional):
string
Minimum Length:
1
Maximum Length:50
Pattern:^[a-zA-Z0-9 ]*$
Shore G IdExample:G1
-
shoreResId(optional):
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]
Shore Reservation IdExample:S1
-
stateroomNumber(optional):
string
Minimum Length:
1
Maximum Length:20
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Stateroom number / Cabin number * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `P`, `R`, `C` Profile Types * Ignored if given only other Profile TypesExample:B1001
Nested Schema : discountTemplate
Type:
object
Discount Template
Show Source
-
code(optional):
string
Discount Template CodeExample:
LV2
-
description(optional):
string
Discount Template DescriptionExample:
Disc Template 2
Nested Schema : disembarkationHarbor
Type:
object
disembarkationHarbor
Show Source
-
code(optional):
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Disembarkation Harbor Code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:AGSJO
-
description(optional):
string
Disembarkation Harbor Code DescriptionExample:
To Land
Nested Schema : document
Type:
object
Document
Show Source
-
isDocumentChecked(optional):
boolean
Document Is CheckedExample:
false
-
isDocumentCollected(optional):
boolean
Document Is CollectExample:
false
Nested Schema : embarkationHarbor
Type:
object
Embarkation Harbor
Show Source
-
code(optional):
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Embarkation Harbor Code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:AGSJO
-
description(optional):
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]
Embarkation Harbor Code DescriptionExample:To Sea
Nested Schema : lifeBoat
Type:
object
Life Boat
Show Source
-
code(optional):
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Lifeboat CodeExample:L1
-
description(optional):
string
Lifeboat Code DescriptionExample:
Guest Boat A
Nested Schema : musterStation
Type:
object
musterStation
Show Source
-
code(optional):
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z0-9- ]*$
Muster Station Code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `P`, `R`, `C` Profile Types * Ignored if given only other Profile TypesExample:A
-
description(optional):
string
Musterstation Code DescriptionExample:
Guest Deck 1
Nested Schema : otherParameter
Type:
object
Other Parameters
Show Source
-
isAirSeaOperator(optional):
boolean
Is Air Sea OperatorExample:
false
-
isChargeCheckedOutCalls(optional):
boolean
Is Charge For Checked Out CallsExample:
false
-
isCompleteOnlineForm(optional):
boolean
Is Complete Online FormExample:
false
-
isExpressCheckOut(optional):
boolean
Is Express CheckoutExample:
false
-
isGroupLeader(optional):
boolean
Is Group LeaderExample:
false
-
isKioskCheckInAllowed(optional):
boolean
Is Kiosk Check In AllowedExample:
false
-
isNonInclusiveGuestType(optional):
boolean
Is Non Inclusive Guest TypeExample:
false
-
isResident(optional):
boolean
Is ResidentExample:
false
-
isStayOvernightTour(optional):
boolean
Is Stay Overnight TourExample:
false
-
isSwitchToCrewManifest(optional):
boolean
Is Switch To Crew ManifestExample:
false
Nested Schema : profileInformation
Type:
object
Profile Information
Show Source
-
birthPlace(optional):
string
Maximum Length:
50
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Birth Place * `null` if emptyExample:KL
-
dateOfBirth(optional):
string(ISO 8601 (YYYY-MM-DD))
Date of BirthExample:
1970-02-15
-
firstName(optional):
string
Minimum Length:
1
Maximum Length:40
Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$
First name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:Doe
-
gender(optional):
object gender
Gender
-
guestCategories(optional):
array guestCategory
-
lastName(optional):
string
Minimum Length:
1
Maximum Length:40
Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$
Last name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:Jaden
-
maritalStatus(optional):
object maritalStatus
Marital Status
-
middleName(optional):
string
Minimum Length:
1
Maximum Length:40
Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$
Middle name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:Jay
-
nationalId(optional):
string
Maximum Length:
20
Pattern:^[a-zA-Z0-9 ]+?$
National Id * `null` if emptyExample:1234
-
nationality(optional):
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9_@./#&+-]*$
Nationality code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:US
-
otherFirstName(optional):
string
Other First NameExample:
Mäya
-
otherLastName(optional):
string
Other Last NameExample:
Wälters
-
passportIssuedCountry(optional):
object passportIssuedCountry
Passport Issued Country
-
passportIssuedDate(optional):
string(ISO 8601)
Passport Issued DateExample:
2009-10-31
-
passportIssuedExpiryDate(optional):
string(date)
Passport Issued Expiry DateExample:
2018-11-11
-
passportIssuedPlace(optional):
string
Passport Issued PlaceExample:
Paramount
-
passportNumber(optional):
string
Minimum Length:
1
Maximum Length:20
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Passport number * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:A123409982
-
permanentResidentId(optional):
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]
Permanent ResidentExample:P123
-
profileId(optional):
integer
Profile IDExample:
1234
-
royaltyNumber(optional):
string
Maximum Length:
20
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Royalty Number * `null` if emptyExample:a1234
-
salutation(optional):
string
SalutationExample:
Dr.
-
title(optional):
string
TitleExample:
Countess
-
vip(optional):
object vip
VIP
Nested Schema : gender
Type:
object
Gender
Show Source
-
code(optional):
string
Pattern:
^[FMX]$
Gender CodeExample:F
-
description(optional):
string
Gender NameExample:
Female
Nested Schema : guestCategory
Type:
Show Source
array
-
Array of:
object guestCategoryGroup
Guest Category Group
Nested Schema : maritalStatus
Type:
object
Marital Status
Show Source
-
code(optional):
object maritalStatusCode
maritalStatusCode
-
description(optional):
string
Marital Status DescriptionExample:
Single
Nested Schema : passportIssuedCountry
Type:
object
Passport Issued Country
Show Source
-
code(optional):
string
Minimum Length:
1
Maximum Length:6
Country Code * `null` if emptyExample:US
-
description(optional):
string
Country NameExample:
Malaysia
Nested Schema : vip
Type:
object
VIP
Show Source
-
code(optional):
string
Maximum Length:
6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
VIP CodeExample:L1
-
description(optional):
string
VIP Code DescriptionExample:
Minister
Nested Schema : guestCategoryGroup
Type:
object
Guest Category Group
Show Source
-
code(optional):
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]
Guest Category CodesExample:GC1
-
description(optional):
string
Pattern:
[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]
Guest Category Codes DescriptionExample:Couple
Nested Schema : maritalStatusCode
Type:
object
maritalStatusCode
Show Source
-
code(optional):
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z0-9 ]{1,6}$
Marital Status CodeExample:D
-
comments(optional):
string
Maximum Value:
4000
Account Category CommentsExample:The term profit and loss (P&L) statement refers to a financial statement that summarizes the revenues, costs, and expenses incurred during a specified period, usually a quarter or fiscal year. These records provide information about a companys ability or inability to generate profit by increasing revenue, reducing costs, or both. These statements are often presented on a cash or accrual basis.
-
description(optional):
string
Minimum Value:
1
Maximum Value:1000
Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$
Account Category DescriptionExample:Profit and Loss Account
-
id(optional):
string
Minimum Length:
1
Maximum Length:10
Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
Currency Exchange IdExample:12345
-
isEnabled(optional):
boolean
This is to indicate switch to enable / disable account category (default value: true) * `true` - Enable account category * `false` - Disable account categoryExample:
true
204 Response
No Content
400 Response
Bad Request
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
401 Response
Unauthorized
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
403 Response
Forbidden
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"https://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
405 Response
Method Not Allowed
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
406 Response
Not Acceptable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
500 Response
Internal Server Error
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
503 Response
Service Unavailable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
"title":"Service Unavailable",
"detail":"Service Unavailable. Try again later"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source