Retrieve a crew reservation record
get
/spms/v2/ships/{shipId}/reservations/crews
This is to retrieve the crew reservation details.
Request
Supported Media Types
- application/json
Path Parameters
-
shipId(required): number
Ship Id
Query Parameters
-
bookingNumber: string
Booking Number
-
cabinNumber: string
Cabin 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 Value:
1Paging limitDefault Value:50 -
offset: integer(int32)
Minimum Value:
0Paging offsetDefault Value:0 -
orderBy: string
order by embarkationDate, reservationStatus, disembarkationDate, bookingNumber, cabinNumber with format column1:asc/desc,column2:asc/desc,column3:asc/desc,column4:asc/desc,column5:asc/desc
-
profileId: number
Profile Id
-
reservationId: number
Reservation Id
-
reservationStatus: string
Pattern:
^RR|RE|CC|CL|DD|RN|RX$Reservation Status, RR=Reservation, RX=Cancelled, RE=Embark today, RN=No Show, CC=Checked In, CL=Leaving today, DD=Disembarked. -
setSailPassNumber: string
Set Sail Pass Number
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : Crew Reservation GET Success Oracle Responses list
Type:
objectTitle:
Crew Reservation GET Success Oracle Responses listThe wrapper object when returning successful values in Oracle standard
Show Source
-
count:
number
The total number of items in the list.Example:
10 -
hasMore:
boolean
Flag which indicates whether or not there are more items.Example:
true -
items:
array items
-
limit:
number
Paging limitExample:
5 -
offset:
number
Paging offsetExample:
10
Nested Schema : items
Type:
Show Source
array-
Array of:
object crewReservationResponse
Crew Reservation response
Example:
[
{
"reservationId":10001,
"guestCategories":[
{
"code":"GCAT",
"description":"Guest Category"
}
],
"bookingNumber":"12345678",
"shoreGId":"12345678",
"extResId":"12345678",
"boardCardNumber":"12345678",
"setSailPassNumber":"1234",
"finNumber":"12345678",
"expectedEmbarkationDate":"2024-01-01",
"expectedEmbarkationHarbor":"NEW YORK CITY",
"expectedDisembarkationDate":"2025-01-01",
"expectedDisembarkationHarbor":"DUBAI",
"actualEmbarkationDate":"2024-01-01",
"actualEmbarkationHarbor":"DUBAI",
"reEmbarkationDate":"2024-01-01",
"embarkationHarborComment":"Going to the sea",
"disembarkationHarborComment":"Going to the land",
"reservationStatus":"CC",
"cabinNumber":"12345",
"berthNumber":"A",
"musterStation":{
"code":"M",
"description":"Guest Deck 1"
},
"lifeBoat":{
"code":"L1",
"description":"Guest Boat A"
},
"denyBoardingFlag":true,
"denyBoardingReason":"Passport Issue",
"pinCode":1234,
"longShoremanWork":true,
"assign":"A",
"onboardStatus":true,
"discountTemplate":"ABCD",
"paymentDetails":{
"paymentMethodCode":"1234",
"paymentRemarks":"Example Payment Remark"
},
"otherParameter":{
"isManifestPrintout":true,
"isSwitchToPassengerManifest":true,
"isStayOvernightTour":true,
"isNoticeAndConsent":true
},
"onboardEmail":"example@email.com",
"profileInformation":{
"profileId":10001,
"lastName":"Carleo",
"firstName":"Fabiana",
"middleName":"Alberto",
"otherLastName":"Francis",
"otherFirstName":"Frost",
"title":"Mr.",
"salutation":"Mr.",
"gender":{
"code":"M",
"description":"Male"
},
"dateOfBirth":"2018-11-11",
"nationality":{
"code":"MY",
"description":"Malaysia"
},
"nationId":"123456",
"birthPlace":"Dubai",
"hairColor":"Black",
"eyeColor":"Brown",
"height":"1.80 cm",
"weight":70,
"isSmoker":true,
"isIntoxication":true,
"passportNumber":"A123456",
"passportIssuedDate":"2018-11-11",
"passportIssuedExpiryDate":"2026-11-11",
"passportIssuedCountry":{
"code":"MY",
"description":"Malaysia"
},
"passportIssuedPlace":"Shah Alam",
"maritalStatus":{
"code":"S",
"description":"Single"
},
"seamanBookNumber":"12345678",
"seamanBookIssuedDate":"2024-11-11",
"seamanBookExpiryDate":"2025-11-11",
"seamanBookIssuedPlace":"KL",
"seamanBookIssuedCountry":{
"code":"MY",
"description":"Malaysia"
},
"operationalDepartment":{
"code":"S1001",
"descriptione":"DECK"
},
"departmentPosition":{
"code":"D1001",
"description":"STAFF CAPTAIN"
},
"externalId":"12345678",
"internalId":"12345678",
"crewPostId":"12345678",
"orderEmpNo":12345678
}
}
]Nested Schema : crewReservationResponse
Type:
objectCrew Reservation response
Show Source
-
actualEmbarkationDate:
string(date)
Actual Embarkation DateExample:
2024-01-01 -
actualEmbarkationHarbor:
string
Actual Embarkation HarborExample:
DUBAI -
assign:
string
AssignExample:
A -
berthNumber:
string
Minimum Length:
1Maximum Length:1Pattern:^[a-zA-Z0-9 ]+?$Berth NumberExample:A -
boardCardNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 ]+?$Board Card NumberExample:12345678 -
bookingNumber:
string
Minimum Length:
1Maximum Length:100Booking NumberExample:12345678 -
cabinNumber:
string
Minimum Length:
1Maximum Length:20Cabin NumberExample:12345 -
denyBoardingFlag:
boolean
Deny Boarding FlagExample:
true -
denyBoardingReason:
string
Maximum Length:
40Deny Boarding ReasonExample:Passport Issue -
discountTemplate:
object discountTemplate
Discount Template
-
disembarkationHarborComment:
string
Maximum Length:
20Disembarkation Harbor CommentExample:Going to the land -
embarkationHarborComment:
string
Maximum Length:
20Embarkation Harbor CommentExample:Going to the sea -
expectedDisembarkationDate:
string(date)
Expected Disembarkation DateExample:
2025-01-01 -
expectedDisembarkationHarbor:
string
Expected Disembarkation HarborExample:
DUBAI -
expectedEmbarkationDate:
string(date)
Expected Embarkation DateExample:
2024-01-01 -
expectedEmbarkationHarbor:
string
Expected Embarkation HarborExample:
NEW YORK CITY -
extResId:
string
Minimum Length:
1Maximum Length:50External Reservation IdExample:12345678 -
finNumber:
string
Maximum Length:
20FIN Number * `null` if emptyExample:a1234 -
guestCategories:
array guestCategoryGET
-
lifeBoat:
object lifeBoat
Life Boat
-
longShoremanWork:
boolean
Long Shoreman WorkExample:
true -
musterStation:
object musterStation
Muster Station
-
onboardEmail:
string
Minimum Length:
1Maximum Length:72Pattern:^([a-zA-Z0-9_\-\.]+)@([a-zA-Z0-9_\-]+)(\.([a-zA-Z]{2,5})){1,}$Onboard Email AddressExample:example@email.com -
onboardStatus:
boolean
Onboard StatusExample:
true -
otherParameter:
object otherParameter
Other Parameter
-
paymentDetails:
object paymentDetails
Payment Details
-
pinCode:
number
PincodeExample:
1234 -
profileInformation:
object profileInformationResponse
Profile information response
-
reEmbarkationDate:
string(date)
Return Embarkation DateExample:
2024-01-01 -
reservationId:
object reservationId
Reservation Id
-
reservationStatus:
string
Minimum Length:
2Maximum Length:2Pattern:^RR|RE|CC|CL|DD|RN|RX$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:
1Maximum Length:30Set Sail Pass NumberExample:1234 -
shoreGId:
string
Minimum Length:
1Maximum Length:15Shore G IdExample:12345678
Nested Schema : discountTemplate
Type:
objectDiscount Template
Show Source
-
code:
string
Discount Template CodeExample:
LV2 -
description:
string
Discount Template DescriptionExample:
Disc Template 2
Nested Schema : guestCategoryGET
Type:
Show Source
array-
Array of:
object guestCategoryGETGroup
Guest Category Items
Nested Schema : lifeBoat
Type:
objectLife Boat
Show Source
-
code:
string
Maximum Length:
6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Life Boat CodeExample:L1 -
description:
string
Life Boat Code DescriptionExample:
Guest Boat A
Nested Schema : musterStation
Type:
objectMuster Station
Show Source
-
code:
string
Maximum Length:
6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Muster Station CodeExample:M -
description:
string
Muster Station Code DescriptionExample:
Guest Deck 1
Nested Schema : otherParameter
Type:
objectOther Parameter
Show Source
-
isManifestPrintout:
boolean
Is Manifest PrintoutExample:
true -
isNoticeAndConsent:
boolean
Acknowledge Notice and ConsentExample:
true -
isStayOvernightTour:
boolean
Is Stay Overnight TourExample:
true -
isSwitchToPassengerManifest:
boolean
Is Switch To Passenger ManifestExample:
true
Nested Schema : paymentDetails
Type:
objectPayment Details
Show Source
-
paymentMethodCode:
string
Maximum Length:
10Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Payment Method CodeExample:1234 -
paymentRemarks:
string
Maximum Length:
3000Payment RemarksExample:Example Payment Remark
Nested Schema : profileInformationResponse
Type:
objectProfile information response
Show Source
-
birthPlace:
string
Maximum Length:
50Birth Place * `null` if emptyExample:KL -
crewPostId:
string
Minimum Length:
1Maximum Length:15Crew Post IDExample:12345678 -
dateOfBirth:
string(ISO 8601 (YYYY-MM-DD))
Date Of BirthExample:
1999-02-15 -
departmentPosition:
object departmentPosition
Department Position
-
externalId:
string
Minimum Length:
1Maximum Length:20Crew External IDExample:12345678 -
eyeColor:
string
Maximum Length:
20Eye ColorExample:Brown -
firstName:
string
Minimum Length:
1Maximum Length:40The first name of the guestExample:Kobe -
gender:
object gender
Gender
-
hairColor:
string
Maximum Length:
20Hair ColorExample:Black -
height:
string
Minimum Length:
0Maximum Length:10HeightExample:190 -
internalId:
string
Minimum Length:
1Maximum Length:20Crew Internal IDExample:12345678 -
isIntoxication:
boolean
Is IntoxicationExample:
true -
isSmoker:
boolean
Is SmokerExample:
true -
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 -
nationality:
object nationality
Nationality
-
nationId:
string
Minimum Length:
1Maximum Length:20Nation IdExample:123456 -
operationalDepartment:
object operationalDepartment
Operational Department
-
orderEmpNo:
number
Order Employee NumberExample:
12345678 -
otherFirstName:
string
Other First NameExample:
Mäya -
otherLastName:
string
Other Last NameExample:
Wälters -
passportIssuedCountry:
object passportIssuedCountry
Passport Issued Country
-
passportIssuedDate:
string(ISO 8601)
Passport Issued DateExample:
2009-10-31 -
passportIssuedExpiryDate:
string(date)
Passport Issued Expiry DateExample:
2026-11-11 -
passportIssuedPlace:
string
Maximum Length:
50Passport Issued PlaceExample:Shah Alam -
passportNumber:
string
Passport NumberExample:
A1510202 -
profileId:
integer
Profile IDExample:
1001 -
salutation:
string
Minimum Length:
1Maximum Length:20The salutation of the guestExample:Mr. -
seamanBookExpiryDate:
string(date)
Seaman Book Expiry DateExample:
2025-11-11 -
seamanBookIssuedCountry:
object seamanBookIssuedCountry
Passport Issued Country
-
seamanBookIssuedDate:
string(ISO 8601)
Seaman Book Issued DateExample:
2009-10-31 -
seamanBookIssuedPlace:
string
Minimum Length:
1Maximum Length:50Passport Issued PlaceExample:Kuala Lumpur -
seamanBookNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Seaman Book NumberExample:ABC12345678 -
title:
string
TitleExample:
Countess -
weight:
number
WeightExample:
70
Nested Schema : reservationId
Type:
objectReservation Id
Show Source
-
onBoardStatus:
integer
Example:
0 -
reservationId:
integer(int64)
Example:
989323
Nested Schema : guestCategoryGETGroup
Type:
objectGuest Category Items
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,\?/\.\-\\+\* ~!@#$%&{}\[\]()=<>\|\^\'\":;@`]*$Guest Category CodeExample:GCAT -
description:
string
Guest Category Code DescriptionExample:
Guest Category
Nested Schema : departmentPosition
Type:
objectDepartment Position
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Department Position CodeExample:D1001 -
description:
string
Department Position DescriptionExample:
STAFF CAPTAIN
Nested Schema : gender
Type:
objectGender
Show Source
-
code:
string
Gender CodeExample:
F -
description:
string
Gender DescriptionExample:
Female
Nested Schema : maritalStatus
Type:
objectMarital Status
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 ]{1,6}$Marital Status CodeExample:D -
description:
string
Marital Status DescriptionExample:
Single
Nested Schema : nationality
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 : operationalDepartment
Type:
objectOperational Department
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Operational Department CodeExample:S1001 -
description:
string
Operational Department DescriptionExample:
DECK
Nested Schema : passportIssuedCountry
Type:
objectPassport Issued Country
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Country CodeExample:MY -
description:
string
Country NameExample:
Malaysia
Nested Schema : seamanBookIssuedCountry
Type:
objectPassport Issued Country
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Country CodeExample:MY -
description:
string
Country NameExample:
Malaysia
204 Response
No Content
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":"The parameter 'shipId' has incorrect format"
}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":"You are forbidden to use this API"
}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 Allowed
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
415 Response
Unsupported Media Type
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