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(required): 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
Pattern:
^RR|RE|CC|CL|DD|RN|RX$
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
-
agentDetails:
object agentDetails
Agent Details
-
boardCardNumber:
string
Pattern:
^[a-zA-Z0-9 ]+?$
Board Card NumberExample:100500333
-
bookingNumber:
string
Minimum Length:
1
Maximum Length:100
Booking NumberExample:123456789
-
diningDetails:
object diningDetails
Dining Details
-
discountTemplate:
object grDiscountTemplate
Discount Template
-
disembarkationDate:
string(date)
Disembarkation DateExample:
2018-11-11
-
disembarkationHarbor:
object grDisembarkationHarbor
Disembarkation Harbor
-
disembarkationHarborComments:
string
Maximum Length:
20
disembarkation harbor commentsExample:Going to the land
-
document:
object document
Document
-
embarkationDate:
string(date)
Embarkation DateExample:
2018-11-11
-
embarkationHarbor:
object embarkationHarbor
Embarkation Harbor
-
embarkationHarborComments:
string
Maximum Length:
20
Embarkation harbor commentsExample:Going to the sea
-
isNoticeAndConsent:
boolean
Acknowledge Notice and ConsentExample:
true
-
lifeBoat:
object lifeBoat
Life Boat
-
manifestPrintout:
boolean
Manifest PrintoutExample:
false
-
musterStation:
object grMusterStation
musterStation
-
numberOfCruiseDays:
integer
Minimum Value:
0
Maximum Value:99999999
Total Number Of Cruise DaysExample:1
-
numberOfCruises:
integer
Minimum Value:
0
Maximum Value:99999999
Number Of CruisesExample:1
-
onboardEmail:
string
Minimum Length:
1
Maximum Length:72
Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$
Onboard Email Address * `null` if emptyExample:email@example.com
-
onboardStatus:
boolean
onboardStatusExample:
false
-
otherParameter:
object otherParameter
Other Parameters
-
profileInformation:
object profileInformation
Profile Information
-
queueId:
integer
Minimum Value:
0
Maximum Value:99999999
Queue IdExample:11
-
reservationId:
number
Minimum Length:
1
Pattern:^[0-9]*$
Reservation IdExample:1001
-
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
Minimum Length:
1
Maximum Length:30
Set Sail Pass NumberExample:3388
-
shoreGId:
string
Minimum Length:
1
Maximum Length:50
Shore G IdExample:G1
-
shoreResId:
string
Minimum Length:
1
Maximum Length:15
Shore Reservation IdExample:S1
-
stateroomNumber:
string
Minimum Length:
1
Maximum Length:20
stateroomNumberExample:1001
Nested Schema : agentDetails
Type:
object
Agent Details
Show Source
-
agentBookingId:
string
Minimum Length:
0
Maximum Length:20
Agent Booking IdExample:A123
-
agentId:
string
Minimum Length:
0
Maximum Length:20
Agent IdExample:A123
-
agentReferenceId:
string
Minimum Length:
0
Maximum Length:20
Agent Reference IdExample:A123
Nested Schema : diningDetails
Type:
object
Dining Details
Show Source
-
otherSeating:
string
Minimum Length:
0
Maximum Length:50
Other SeatingExample:A123
-
referenceTableId:
number
Minimum Value:
0
Reference Table IdExample:123
-
restaurantSeating:
string
Minimum Length:
0
Maximum Length:10
Restaurant SeatingExample:A123
-
tableAssignment:
string
Minimum Length:
0
Maximum Length:3
Table AssignmentExample:A123
Nested Schema : grDiscountTemplate
Type:
object
Discount Template
Show Source
-
code:
string
Pattern:
^[ A-Za-z0-9,'_@./#&+-]*$
Discount Template CodeExample:A1
-
description:
string
Discount Template DescriptionExample:
Loyal Guest
Nested Schema : grDisembarkationHarbor
Type:
object
Disembarkation Harbor
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Disembarkation Harbor CodeExample:D1
-
description:
string
Disembarkation Harbor Code DescriptionExample:
To Land
Nested Schema : document
Type:
object
Document
Show Source
-
isDocumentChecked:
boolean
Document Is CheckedExample:
false
-
isDocumentCollected:
boolean
Document Is CollectExample:
false
Nested Schema : embarkationHarbor
Type:
object
Embarkation Harbor
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Embarkation Harbor CodeExample:E1
-
description:
string
Embarkation Harbor Code DescriptionExample:
To Sea
Nested Schema : lifeBoat
Type:
object
Life Boat
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Lifeboat CodeExample:L1
-
description:
string
Lifeboat Code DescriptionExample:
Guest Boat A
Nested Schema : grMusterStation
Type:
object
musterStation
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Musterstation CodeExample:M1
-
description:
string
Musterstation Code DescriptionExample:
Guest Deck 1
Nested Schema : otherParameter
Type:
object
Other 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:
object
Profile Information
Show Source
-
birthPlace:
string
Maximum Length:
50
Birth PlaceExample:Kajang
-
dateOfBirth:
string(ISO 8601 (YYYY-MM-DD))
Date Of BirthExample:
1999-02-15
-
firstName:
string
Minimum Length:
1
Maximum Length:40
First NameExample:Fabiana
-
gender:
object grGender
Gender
-
guestCategories:
array guestCategory
-
lastName:
string
Minimum Length:
1
Maximum Length:40
Last NameExample:Carleo
-
maritalStatus:
object maritalStatus
Marital Status
-
middleName:
string
Minimum Length:
1
Maximum Length:20
Middle Name * `null` if emptyExample:Alberto
-
nationalId:
string
Minimum Length:
1
Maximum Length:20
National IdExample:22A
-
nationality:
object grNationalityStruct
Nationality
-
otherFirstName:
string
Minimum Length:
1
Maximum Length:80
Other First Name * `null` if emptyExample:Frost
-
otherLastName:
string
Minimum Length:
1
Maximum Length:100
Other Last Name * `null` if emptyExample:Francis
-
passportIssuedCountry:
object grPassportIssuedCountry
Passport Issued Country
-
passportIssuedDate:
string(ISO 8601)
Passport Issued DateExample:
2009-10-31
-
passportIssuedExpiryDate:
string(date)
Passport Issued Expiry DateExample:
2018-11-11
-
passportIssuedPlace:
string
Maximum Length:
50
Passport Issued PlaceExample:Shah Alam
-
passportNumber:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Passport NumberExample:A145611
-
permanentResidentId:
string
Maximum Length:
30
Permanent ResidentExample:P123
-
profileId:
number
Minimum Length:
1
Pattern:^[0-9]*$
Profile IdExample:12345
-
royaltyNumber:
string
Maximum Length:
20
Royalty NumberExample:a1234
-
salutation:
string
Minimum Length:
1
Maximum Length:20
SalutationExample:MR
-
title:
string
Minimum Length:
1
Maximum Length:20
TitleExample:MR
-
vip:
object vip
VIP
Nested Schema : grGender
Type:
object
Gender
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ 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:
object
Marital Status
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Marital Status CodeExample:S
-
description:
string
Marital Status DescriptionExample:
Single
Nested Schema : grNationalityStruct
Type:
object
Nationality
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Nationality CodeExample:MY
-
description:
string
Nationality Code DescriptionExample:
Malaysia
Nested Schema : grPassportIssuedCountry
Type:
object
Passport Issued Country
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Passport Issued Country CodeExample:MY
-
description:
string
Passport Issued Country Code DescriptionExample:
Malaysia
Nested Schema : vip
Type:
object
VIP
Show Source
-
code:
string
Maximum Length:
6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
VIP CodeExample:L1
-
description:
string
VIP Code DescriptionExample:
Minister
Nested Schema : guestCategoryGroup
Type:
object
Guest Category Group
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:[a-zA-Z0-9 ] ~!@#$%^&*()_+-<>?/\|,.":;{}[]
Guest Category CodesExample:GC1
-
description:
string
Guest Category Codes DescriptionExample:
Couple
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