Update crew reservation
put
/spms/v2/ships/{shipId}/reservations/crews/{reservationId}
This is to update a crew reservation record.
Request
Supported Media Types
- application/json
Path Parameters
-
reservationId(required): integer(int32)
Minimum Value:
1Reservation Id -
shipId(required): number
Ship Id
Crew reservation request
Root Schema : crewReservationRequest
Type:
objectCrew reservation request
Show Source
-
berthNumber:
string
Minimum Length:
1Maximum Length:1Pattern:^[a-zA-Z0-9 ]+?$Berth NumberExample:A -
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(required):
string(date)
Expected Disembarkation DateExample:
2025-01-01 -
expectedDisembarkationHarborCode(required):
string
Maximum Length:
6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Expected Disembarkation Harbor CodeExample:PQRST -
expectedEmbarkationDate(required):
string(date)
Expected Embarkation DateExample:
2024-01-01 -
expectedEmbarkationHarborCode(required):
string
Maximum Length:
6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Expected Embarkation Harbor CodeExample:ABCDE -
extResId:
string
Minimum Length:
1Maximum Length:50External Reservation IdExample:12345678 -
finNumber:
string
Maximum Length:
20FIN Number * `null` if emptyExample:a1234 -
guestCategories:
array guestCategories
-
lifeBoat:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Lifeboat CodeExample:L1 -
longShoremanWork:
boolean
Long Shoreman WorkExample:
true -
musterStation:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Musterstation CodeExample:M1 -
onboardEmail:
string
Minimum Length:
1Maximum Length:72Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$Onboard Email Address * `null` if emptyExample:email@example.com -
onboardStatus:
boolean
Onboard StatusExample:
true -
otherParameter:
object otherParameter
Other Parameters
-
paymentDetails:
object paymentDetails
Payment Details
-
pinCode:
number
PincodeExample:
1234 -
profileInformation:
object profileInformationRequest
Profile information request
-
reEmbarkationDate:
string(date)
Return Embarkation DateExample:
2024-01-01 -
setSailPassNumber:
string
Minimum Length:
1Maximum Length:30Set Sail Pass NumberExample:3388 -
shoreGId:
string
Minimum Length:
1Maximum Length:50Shore G IdExample:G1
Nested Schema : discountTemplate
Type:
objectDiscount Template
Show Source
-
code:
string
Discount Template CodeExample:
LV2 -
description:
string
Discount Template DescriptionExample:
Disc Template 2
Nested Schema : guestCategories
Type:
Show Source
array-
Array of:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,\?/\.\-\\+\* ~!@#$%&{}\[\]()=<>\|\^\'\":;@`]*$Guest Category CodeExample:GCAT
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 : 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 : profileInformationRequest
Type:
objectProfile information request
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 -
externalId:
string
Minimum Length:
1Maximum Length:20Crew External IDExample:12345678 -
eyeColor:
string
Maximum Length:
20Eye ColorExample:Brown -
firstName(required):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]First NameExample:Fabiana -
gender:
string
Gender CodeExample:
F -
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(required):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Last NameExample:Carleo -
maritalStatus:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Marital Status CodeExample:S -
middleName:
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Middle NameExample:Alberto -
nationality:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Nationality CodeExample:MY -
nationId:
string
Minimum Length:
1Maximum Length:20Nation IdExample:123456 -
orderEmpNo:
number
Order Employee NumberExample:
12345678 -
otherFirstName:
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Other First NameExample:Frost -
otherLastName:
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Other Last NameExample:Francis -
passportIssuedCountry:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Passport Issued Country CodeExample:MY -
passportIssuedDate:
string(ISO 8601)
Passport Issued DateExample:
2009-10-31 -
passportIssuedExpiryDate:
string(date)
Passport Issued Expiry DateExample:
2018-11-11 -
passportIssuedPlace:
string
Maximum Length:
50Passport Issued PlaceExample:Shah Alam -
passportNumber:
string
Passport NumberExample:
A1510202 -
salutation:
string
Minimum Length:
1Maximum Length:20Pattern:[a-z]SalutationExample:MR -
seamanBookExpiryDate:
string(date)
Seaman Book Expiry DateExample:
2025-11-11 -
seamanBookIssuedCountry:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Seaman Book Issued Country CodeExample:MY -
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
Response
Supported Media Types
- application/json
200 Response
Updated
Root 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:
1Pattern:^[a-zA-Z0-9]+$Booking NumberExample:0123456789 -
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:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$Onboard Email Address * `null` if emptyExample:email@example.com -
onboardStatus:
boolean
Onboard StatusExample:
true -
otherParameter:
object otherParameter
Other Parameters
-
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:
number
Minimum Length:
1Pattern:^[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:
1Maximum Length:30Set Sail Pass NumberExample:3388 -
shoreGId:
string
Minimum Length:
1Maximum Length:50Shore G IdExample:G1
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
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Lifeboat CodeExample:L1 -
description:
string
Lifeboat Code DescriptionExample:
Guest Boat A
Nested Schema : musterStation
Type:
objectMuster Station
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 : 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:40Pattern:[a-z]First NameExample:Fabiana -
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:40Pattern:[a-z]Last NameExample:Carleo -
maritalStatus:
object maritalStatus
Marital Status
-
middleName:
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Middle NameExample:Alberto -
nationality:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Nationality code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:US -
nationId:
string
Minimum Length:
1Maximum Length:20Nation IdExample:123456 -
operationalDepartment:
object operationalDepartment
Operational Department
-
orderEmpNo:
number
Order Employee NumberExample:
12345678 -
otherFirstName:
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Other First NameExample:Frost -
otherLastName:
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Other Last NameExample:Francis -
passportIssuedCountry:
object passportIssuedCountry
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:
50Passport Issued PlaceExample:Shah Alam -
passportNumber:
string
Passport NumberExample:
A1510202 -
profileId:
number
Minimum Length:
1Pattern:^[0-9]*$Profile IdExample:1001 -
salutation:
string
Minimum Length:
1Maximum Length:20Pattern:[a-z]SalutationExample: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 : 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 NameExample:
Female
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 : 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
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":"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:
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
409 Response
Conflict
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.10",
"title":"Conflict",
"detail":"Reservation cannot be updated because reservation status is 'DD' or 'RX'"
}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
503 Response
Service Unavailable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError 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:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source