Retrieve reservation and profile details based on criteria
post
/spms/v2/ships/{shipId}/reservations
This is to retrieve reservation and profile details based on criterias.
Request
Supported Media Types
- application/json
Path Parameters
-
shipId: number
Ship Id
Query Parameters
-
limit: integer(int32)
Paging limit
-
offset: integer(int32)
Paging offset.
-
orderBy: string
Default sorting by account ID asc. Order by with format column1:asc/desc,column2:asc/desc * embarkationHarborCode * disembarkationHarborCode * embarkationHarborDescription * disembarkationHarborDescription * crewInternalId * crewExternalId * crewOperationalDepartmentCode * crewOperationalDepartmentDescription * crewOperationalPositionCode * crewOperationalPositionDescription * musterStationCode * musterStationDescription * contactlessId * profileType * firstName * lastName * middleName * accountId * nationalityCode * nationalityDescription * stateroomNumber * boardCardNumber * setSailPass * reservationBookingNumber * passportNumber * embarkationDate * disembarkationDate * onboardStatus * reservationStatusCode * reservationStatusDescription * travelDocumentNumber * crewManningNumber * locationAt
POST Request Object
Root Schema : Reservation Search Request
Type:
objectTitle:
Reservation Search RequestReservation Search Optional Parameters
Show Source
-
accountId(optional):
number
Minimum Value:
1Maximum Value:1.0E38Account ID * `Optional` (Do not provide if not in use) * For all Profile TypesExample:12345 -
boardCardNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Boardcard number * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:A9800000000001 -
contactlessId(optional):
string
Minimum Length:
1Maximum Length:16Pattern:^[a-zA-Z0-9 ]+?$RFID Contactless ID * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:AABB123 -
crewExternalId(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Crew External ID * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `C` Profile Type * Ignored if given only other Profile TypesExample:aaa123 -
crewInternalId(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Crew Internal ID * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `C` Profile Type * Ignored if given only other Profile TypesExample:aaa123 -
crewManningNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 ]+?$Crew manning number * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `C` Profile Type * Ignored if given only other Profile TypesExample:A0002 -
crewOperationalDepartmentCode(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Crew Operational Department Code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `C` Profile Type * Ignored if given only other Profile TypesExample:120 -
crewOperationalPositionCode(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,\?\/\.\-\\+\*\n~!@#$%&\{\}\[\]\(\)=<>\|^'":;`]*$Crew Operational Position Code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `C` Profile Type * Ignored if given only other Profile TypesExample:106 -
disembarkationDate(optional):
string
Reservation disembarkation date * `Optional` (Do not provide if not in use) * For all Profile TypesExample:
2021-01-30 -
disembarkationHarborCode(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Disembarkation Harbor Code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:AGSJO -
embarkationDate(optional):
string
Reservation embarkation date * `Optional` (Do not provide if not in use) * For all Profile TypesExample:
2021-01-26 -
embarkationHarborCode(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Embarkation Harbor Code * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:AGSJO -
firstName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$First name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:Doe -
lastName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$Last name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:Jaden -
locationAt(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Reservation Internal Gate Location * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:ABC23 -
middleName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$Middle name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:Jay -
musterStationCode(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[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 -
nationalityCode(optional):
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 -
onboardStatus(optional):
boolean
Onboard status * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:
true -
passportNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Passport number * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:A123409982 -
profileType(optional):
array profileTypeList
Profile type list. Support multiple values (Example: ['P', 'R']) * `Optional` (Do not provide if not in use)
-
reservationBookingNumber(optional):
string
Minimum Length:
1Maximum Length:100Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Reservation booking 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:ABC001 -
reservationStatus(optional):
array reservationStatusList
Reservation status list. Support multiple values (Example: ['RX', 'RR']) * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile Types
-
searchValue(optional):
string
Minimum Length:
1Maximum Length:100Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$Value to search. Searches (First Name, Last Name, Stateroom number, Boardcard number, Set Sail Pass Number, Booking number, Passport number, Manning number, Contactless ID) * `Optional` (Do not provide if not in use) * For all Profile TypesExample:John -
setSailPass(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Setsailpass number * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `P`, `R` Profile Types * Ignored if given only other Profile TypesExample:ABC001 -
stateroomNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[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 -
travelDocumentNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Travel document number (Visa number) * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile TypesExample:AB11245
Nested Schema : profileTypeList
Type:
arrayProfile type list. Support multiple values (Example: ['P', 'R'])
* `Optional` (Do not provide if not in use)
Show Source
-
Array of:
string
Minimum Length:
1Maximum Length:1Pattern:^[PRCV]$Profile typeExample:P
Nested Schema : reservationStatusList
Type:
arrayReservation status list. Support multiple values (Example: ['RX', 'RR'])
* `Optional` (Do not provide if not in use)
* `null` if searching `null`
* For all Profile Types
Show Source
-
Array of:
string
Minimum Length:
1Maximum Length:2Pattern:^(?:RR|RE|CC|CL|DD|RN|RX)$Reservation status codeExample:RR
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : Reservation search response
Type:
objectTitle:
Reservation search responsereservation search response
Show Source
-
count(optional):
integer
Example:
2 -
items(optional):
array reservationObjectList
List of reservation objects
-
limit(optional):
integer
Example:
10 -
link(optional):
object linkReservations
link (Reservations)
-
offset(optional):
integer
Example:
0
Nested Schema : reservationObjectList
Type:
arrayList of reservation objects
Show Source
-
Array of:
object reservationObject
Reservation object
Nested Schema : linkReservations
Type:
objectlink (Reservations)
Show Source
-
href(optional):
string
Example:
http://[HOSTNAME]/spms/v2/ships/11100777/reservations?searchValue=john&offset=0&limit=2 -
method(optional):
string
Example:
get -
operationId(optional):
string
Example:
search -
rel(optional):
string
Example:
self
Nested Schema : reservationObject
Type:
objectReservation object
Show Source
-
item(optional):
object reservationRecord
Reservation Record Response * There are 4 Profile Types: Guest, Crew, Resident, Visitor * Note: Object returned is based on the reservation record's profile type, it doesn't return all 4 types.
-
links(optional):
array links
Nested Schema : reservationRecord
Type:
objectReservation Record Response
* There are 4 Profile Types: Guest, Crew, Resident, Visitor
* Note: Object returned is based on the reservation record's profile type, it doesn't return all 4 types.
Show Source
-
crew(optional):
object crewDetails
Crew information based on the Profile id passed
-
guest(optional):
object guestDetails
Guest information based on the Profile id passed
-
resident(optional):
object residentDetails
Resident information based on the Profile id passed
-
visitor(optional):
object visitorDetails
Visitor information based on the Profile id passed
Nested Schema : links
Type:
Show Source
array-
Array of:
object profileLinkObject
Profile Link object
Nested Schema : crewDetails
Type:
objectCrew information based on the Profile id passed
Show Source
-
accountId(optional):
integer
Minimum Value:
1Example:12345 -
accountType(optional):
string
Allowed Values:
[ "A", "P", "C", "G", "V", "O" ]Pattern:^A|P|C|G|V|O$Example:System Account, Passenger, Crew, Group, Visitor -
actualDisembarkDate(optional):
string(date-time)
Example:
null or 2015-09-09 -
actualEmbarkDate(optional):
string(date-time)
Example:
2015-09-02 -
age(optional):
integer(int32)
Minimum Value:
1Maximum Value:150Example:57 -
alternativeContactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
assemblyStationCode(optional):
string
Minimum Length:
0Maximum Length:6Pattern:[a-z0-9]Example:12345 -
assemblyStationName(optional):
string
Minimum Length:
1Maximum Length:50Pattern:[a-z0-9]Example:12345 -
boardCardNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:123456789 -
cabinNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:11111 -
classification(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:[VIP] -
consentStatus(optional):
integer
Example:
0 -
contactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
countryOfBirth(optional):
string
Minimum Length:
1Maximum Length:3Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
countryOfResidence(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
crewManningNumber(optional):
integer
Minimum Length:
0Maximum Length:38Example:123 -
dateOfBirth(optional):
string(date-time)
Example:
1961-04-01 -
disembarkDate(optional):
string(date-time)
Example:
2015-09-09 -
disembarkPort(optional):
integer
Example:
123 -
documentExpiryDate(optional):
string(date-time)
Example:
1961-04-01 -
documentIssuedCountry(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
documentIssuedDate(optional):
string(date-time)
Example:
1961-04-01 -
emailAddress(optional):
string
Minimum Length:
1Maximum Length:50Pattern:^([a-zA-Z0-9_\\-\\.]+)@([a-zA-Z0-9_\\-\\.]+)\\.([a-zA-Z]{2,5})$Example:EMAIL ADD -
embarkDate(optional):
string(date-time)
Example:
2015-09-02 -
embarkPort(optional):
integer
Example:
123 -
emergencyContactName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:John -
emergencyContactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
firstName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:John -
gender(optional):
string
Minimum Length:
1Maximum Length:6Pattern:[A-Z]Example:M or F -
guestId(optional):
integer
Minimum Value:
0Example:12345 -
lastName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:Smith -
middleName(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:Andy -
nationalIdNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:123456789 -
nationality(optional):
string
Minimum Length:
1Maximum Length:6Pattern:[a-z0-9]Example:US -
onboardStatus(optional):
integer
Example:
0 -
operationalDepartment(optional):
string
Example:
Deck Officer -
operationalPosition(optional):
string
Example:
1st Engineer -
passportNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:A01234567 -
photo(optional):
string
Example:
/Images/People/ -
reservationAccountReferenceId(optional):
integer(int32)
Example:
12345 -
reservationAccountType(optional):
string
Minimum Length:
1Maximum Length:1Allowed Values:[ "P", "R", "C", "V" ]Pattern:^P|R|C|V$Example:P -
reservationBookingNumber(optional):
string
Minimum Length:
1Maximum Length:100Pattern:[a-z0-9]Example:0123456789 -
reservationCancelStatus(optional):
boolean
Example:
false -
reservationId(optional):
integer
Minimum Value:
0Example:12345 -
reservationStatus(optional):
string
Reservation status descriptionExample:
Checked In -
salutation(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:MR -
title(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:Mr -
unicodeName(optional):
string
Minimum Length:
1Maximum Length:100Example:
Nested Schema : guestDetails
Type:
objectGuest information based on the Profile id passed
Show Source
-
accountCategory(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^SYS|GRP|CRW|PAX|VTO$Example:PAX -
accountId(optional):
integer
Minimum Value:
1Example:12345 -
accountType(optional):
string
Allowed Values:
[ "A", "P", "C", "G", "V", "O" ]Pattern:^A|P|C|G|V|O$Example:System Account, Passenger, Crew, Group, Visitor -
actualDisembarkDate(optional):
string(date-time)
Example:
null or 2015-09-09 -
actualEmbarkDate(optional):
string(date-time)
Example:
2015-09-02 -
age(optional):
integer(int32)
Minimum Value:
1Maximum Value:150Example:57 -
alternativeContactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
assemblyStationCode(optional):
string
Minimum Length:
0Maximum Length:6Pattern:[a-z0-9]Example:12345 -
assemblyStationName(optional):
string
Minimum Length:
1Maximum Length:50Pattern:[a-z0-9]Example:12345 -
boardCardNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:123456789 -
cabinNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:11111 -
classification(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:[VIP] -
consentStatus(optional):
integer
Example:
0 -
contactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
countryOfBirth(optional):
string
Minimum Length:
1Maximum Length:3Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
countryOfResidence(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
dateOfBirth(optional):
string(date-time)
Example:
1961-04-01 -
disembarkDate(optional):
string(date-time)
Example:
2015-09-09 -
disembarkPort(optional):
integer
Example:
123 -
documentExpiryDate(optional):
string(date-time)
Example:
1961-04-01 -
documentIssuedCountry(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
documentIssuedDate(optional):
string(date-time)
Example:
1961-04-01 -
emailAddress(optional):
string
Minimum Length:
1Maximum Length:50Pattern:^([a-zA-Z0-9_\\-\\.]+)@([a-zA-Z0-9_\\-]+)(\\.([a-zA-Z]{2,5})){1,}$Example:EMAIL ADD -
embarkCruiseId(optional):
integer(int32)
Example:
12345 -
embarkDate(optional):
string(date-time)
Example:
2015-09-02 -
embarkPort(optional):
integer
Example:
123 -
emergencyContactName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:John -
emergencyContactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
firstName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:John -
gender(optional):
string
Minimum Length:
1Maximum Length:6Pattern:[A-Z]Example:M or F -
groupName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:Smith -
groupReferenceId(optional):
integer(int32)
Example:
12345 -
guestId(optional):
integer
Minimum Value:
0Example:12345 -
lastName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:Smith -
middleName(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:Andy -
nationalIdNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:123456789 -
nationality(optional):
string
Minimum Length:
1Maximum Length:6Pattern:[a-z0-9]Example:US -
onboardStatus(optional):
integer
Example:
0 -
passportNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:A01234567 -
photo(optional):
string
Example:
/Images/People/ -
reservationAccountReferenceId(optional):
integer(int32)
Example:
12345 -
reservationAccountType(optional):
string
Minimum Length:
1Maximum Length:1Allowed Values:[ "P", "R", "C", "V" ]Pattern:^P|R|C|V$Example:P -
reservationBookingNumber(optional):
string
Minimum Length:
1Maximum Length:100Pattern:[a-z0-9]Example:0123456789 -
reservationCancelStatus(optional):
boolean
Example:
false -
reservationExternalId(optional):
string
Minimum Length:
1Maximum Length:50Pattern:[a-z0-9]Example:12345 -
reservationId(optional):
integer
Minimum Value:
0Example:12345 -
reservationStatus(optional):
string
Reservation status descriptionExample:
Checked In -
routedAccountNumber(optional):
integer(int32)
Example:
12345 -
salutation(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:MR -
setSailPass(optional):
string
Minimum Length:
1Maximum Length:30Pattern:[a-z0-9]Example:12345 -
title(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:Mr -
unicodeName(optional):
string
Minimum Length:
1Maximum Length:100Example:
Nested Schema : residentDetails
Type:
objectResident information based on the Profile id passed
Show Source
-
accountCategory(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^SYS|GRP|CRW|PAX|VTO$Example:PAX -
accountId(optional):
integer
Minimum Value:
1Example:12345 -
accountType(optional):
string
Allowed Values:
[ "A", "P", "C", "G", "V", "O" ]Pattern:^A|P|C|G|V|O$Example:System Account, Passenger, Crew, Group, Visitor -
actualDisembarkDate(optional):
string(date-time)
Example:
null or 2015-09-09 -
actualEmbarkDate(optional):
string(date-time)
Example:
2015-09-02 -
age(optional):
integer(int32)
Minimum Value:
1Maximum Value:150Example:57 -
alternativeContactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
assemblyStationCode(optional):
string
Minimum Length:
0Maximum Length:6Pattern:[a-z0-9]Example:12345 -
boardCardNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:123456789 -
cabinNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:11111 -
consentStatus(optional):
integer
Example:
0 -
contactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
countryOfBirth(optional):
string
Minimum Length:
1Maximum Length:3Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
countryOfResidence(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
dateOfBirth(optional):
string(date-time)
Example:
1961-04-01 -
disembarkDate(optional):
string(date-time)
Example:
2015-09-09 -
disembarkPort(optional):
integer
Example:
123 -
documentExpiryDate(optional):
string(date-time)
Example:
1961-04-01 -
documentIssuedCountry(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
documentIssuedDate(optional):
string(date-time)
Example:
1961-04-01 -
emailAddress(optional):
string
Minimum Length:
1Maximum Length:50Pattern:^([a-zA-Z0-9_\\-\\.]+)@([a-zA-Z0-9_\\-\\.]+)\\.([a-zA-Z]{2,5})$Example:EMAIL ADD -
embarkCruiseId(optional):
integer(int32)
Example:
12345 -
embarkDate(optional):
string(date-time)
Example:
2015-09-02 -
embarkPort(optional):
integer
Example:
123 -
emergencyContactName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:John -
emergencyContactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
firstName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:John -
gender(optional):
string
Minimum Length:
1Maximum Length:6Pattern:[A-Z]Example:M or F -
groupName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:Smith -
groupReferenceId(optional):
integer(int32)
Example:
12345 -
guestId(optional):
integer
Minimum Value:
0Example:12345 -
lastName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:Smith -
middleName(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:Andy -
nationalIdNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:123456789 -
nationality(optional):
string
Minimum Length:
1Maximum Length:6Pattern:[a-z0-9]Example:US -
onboardStatus(optional):
integer
Example:
0 -
passportNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:A01234567 -
photo(optional):
string
Example:
/Images/People/ -
reservationAccountReferenceId(optional):
integer(int32)
Example:
12345 -
reservationAccountType(optional):
string
Minimum Length:
1Maximum Length:1Allowed Values:[ "P", "R", "C", "V" ]Pattern:^P|R|C|V$Example:P -
reservationBookingNumber(optional):
string
Minimum Length:
1Maximum Length:100Pattern:[a-z0-9]Example:0123456789 -
reservationCancelStatus(optional):
boolean
Example:
false -
reservationExternalId(optional):
string
Minimum Length:
1Maximum Length:50Pattern:[a-z0-9]Example:12345 -
reservationId(optional):
integer
Minimum Value:
0Example:12345 -
reservationStatus(optional):
string
Reservation status descriptionExample:
Checked In -
routedAccountNumber(optional):
integer(int32)
Example:
12345 -
salutation(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:MR -
setSailPass(optional):
string
Minimum Length:
1Maximum Length:30Pattern:[a-z0-9]Example:12345 -
title(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:Mr -
unicodeName(optional):
string
Minimum Length:
1Maximum Length:100Example:
Nested Schema : visitorDetails
Type:
objectVisitor information based on the Profile id passed
Show Source
-
accountId(optional):
integer
Minimum Value:
1Example:12345 -
accountType(optional):
string
Allowed Values:
[ "A", "P", "C", "G", "V", "O" ]Pattern:^A|P|C|G|V|O$Example:System Account, Passenger, Crew, Group, Visitor -
actualDisembarkDate(optional):
string(date-time)
Example:
null or 2015-09-09 -
actualEmbarkDate(optional):
string(date-time)
Example:
2015-09-02 -
age(optional):
integer(int32)
Minimum Value:
1Maximum Value:150Example:57 -
boardCardNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:123456789 -
consentStatus(optional):
integer
Example:
0 -
contactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
countryOfBirth(optional):
string
Minimum Length:
1Maximum Length:3Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
countryOfResidence(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9_@./#&+-]*$Example:US -
dateOfBirth(optional):
string(date-time)
Example:
1961-04-01 -
disembarkDate(optional):
string(date-time)
Example:
2015-09-09 -
emailAddress(optional):
string
Minimum Length:
1Maximum Length:50Pattern:^([a-zA-Z0-9_\\-\\.]+)@([a-zA-Z0-9_\\-\\.]+)\\.([a-zA-Z]{2,5})$Example:EMAIL ADD -
embarkDate(optional):
string(date-time)
Example:
2015-09-02 -
embarkPort(optional):
integer
Example:
123 -
emergencyContactName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:John -
emergencyContactNum(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^\+?(?:[0-9] ?){6,14}[0-9]$Example:+0123456789 -
firstName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:John -
gender(optional):
string
Minimum Length:
1Maximum Length:6Pattern:[A-Z]Example:M or F -
groupName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:Smith -
guestId(optional):
integer
Minimum Value:
0Example:12345 -
lastName(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:Smith -
middleName(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:Andy -
nationality(optional):
string
Minimum Length:
1Maximum Length:6Pattern:[a-z0-9]Example:US -
onboardStatus(optional):
integer
Example:
0 -
passportNum(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:A01234567 -
photo(optional):
string
Example:
/Images/People/ -
reservationAccountType(optional):
string
Minimum Length:
1Maximum Length:1Allowed Values:[ "P", "R", "C", "V" ]Pattern:^P|R|C|V$Example:P -
reservationCancelStatus(optional):
boolean
Example:
false -
reservationId(optional):
integer
Minimum Value:
0Example:12345 -
reservationStatus(optional):
string
Reservation status descriptionExample:
Checked In -
salutation(optional):
string
Minimum Length:
1Maximum Length:40Pattern:[a-z]Example:MR -
title(optional):
string
Minimum Length:
1Maximum Length:20Pattern:[a-z0-9]Example:Mr -
visitorPassType(optional):
string
Minimum Length:
0Maximum Length:6Pattern:^[a-zA-Z0-9- ]*$Example:
Nested Schema : profileLinkObject
Type:
objectProfile Link object
Show Source
-
href(optional):
string
Example:
http://[HOSTNAME]/spms/v2/ships/11100777/profiles/crews/1 -
method(optional):
string
Example:
get -
operationId(optional):
string
Example:
getCrewProfile -
rel(optional):
string
Example:
crew
Example Response (application/json)
{
"count":24,
"hasMore":true,
"link":[
{
"rel":"self",
"method":"post",
"href":"http://[HOSTNAME]/spms/v2/ships/111222333/reservations?offset=0&limit=10",
"operationId":"nextPage"
}
],
"items":[
{
"links":[
{
"rel":"guest",
"href":"http://[HOSTNAME]/spms/v2/ships/111222333/profiles/guests/12345",
"method":"get",
"operationId":"getGuestProfileDetails"
},
{
"rel":"otherTravelDocument",
"href":"http://[HOSTNAME]/spms/v1/guest/12345/otherTravelDocuments",
"method":"get",
"operationId":"getGuestOtherTravelDocuments"
}
],
"item":{
"profileId":12345,
"title":"Mr",
"salutation":"MR",
"firstName":"John",
"middleName":"Andy",
"lastName":"Smith",
"otherFirstName":null,
"otherLastName":null,
"dateOfBirth":"1961-04-01",
"age":57,
"accountCategory":"PAX",
"accountType":"P",
"nationalId":"123456789",
"passportNumber":"A01234567",
"passportIssuedDate":"1961-04-01",
"passportExpiryDate":"1961-04-01",
"passportIssuedCountry":{
"code":"US",
"description":"United States"
},
"passportIssuedPlace":"Paramount",
"birthNation":{
"code":"US",
"description":"United States"
},
"countryOfResidence":{
"code":"US",
"description":"United States"
},
"phoneNumber":123456789,
"temporaryPhoneNumber":123456789,
"emailAddress":"sample@mail.com",
"emergencyContactName":"John",
"emergencyContactNumber":123456789,
"gender":{
"code":"M",
"description":"Male"
},
"nationality":{
"code":"US",
"description":"United States"
},
"discountTemplate":{
"code":"LV1",
"description":"Disc Template 1 - 10%"
},
"reservationAccountReferenceId":12345,
"reservationStatus":{
"code":"CC",
"description":"Checked In"
},
"stateroomNumber":12345,
"reservationAccountType":"P",
"routedAccountNumber":12345,
"onboardStatus":false,
"reservationCancelStatus":false,
"reservationBookingNumber":123456789,
"embarkCruiseId":12345,
"embarkationDate":"2015-09-02",
"actualEmbarkationTime":"07:30:00",
"actualEmbarkationDate":"2015-09-02",
"disembarkationDate":"2015-09-09",
"actualDisembarkationTime":"20:23:00",
"actualDisembarkationDate":null,
"boardCardNumber":"123456789",
"reservationId":12345,
"accountId":12345,
"reservationExternalId":"12345",
"embarkationHarbor":{
"code":"AGSJO",
"description":"ST JOHNS"
},
"disembarkationHarbor":{
"code":"AGSJO",
"description":"ST JOHNS"
},
"groupReferenceId":12345,
"photo":"/Images/People/",
"classification":"CLASS I",
"setSailPass":12345,
"musterStation":{
"code":"A",
"description":"Musterstation A"
},
"groupName":"Smith",
"isNoticeAndConsent":false,
"contactlessId":"abc456",
"locationAt":"ABC23",
"attendImmigrationInspection":1,
"skipImmigrationInspection":false
}
},
{
"links":{
"rel":"crew",
"href":"http://[HOSTNAME]/spms/v2/ships/111222333/profiles/crews/12345",
"method":"get",
"operationId":"getCrewProfile"
},
"item":{
"profileId":12345,
"title":"Mr",
"salutation":"MR",
"firstName":"John",
"middleName":"Andy",
"lastName":"Smith",
"otherFirstName":null,
"otherLastName":null,
"dateOfBirth":"1961-04-01",
"age":57,
"accountType":"C",
"nationalId":"123456789",
"passportNumber":"A01234567",
"passportIssuedDate":"1961-04-01",
"passportExpiryDate":"1961-04-01",
"passportIssuedCountry":{
"code":"US",
"description":"United States"
},
"passportIssuedPlace":"Paramount",
"birthNation":{
"code":"US",
"description":"United States"
},
"countryOfResidence":{
"code":"US",
"description":"United States"
},
"phoneNumber":123456789,
"temporaryPhoneNumber":123456789,
"emailAddress":"sample@mail.com",
"emergencyContactName":"John",
"emergencyContactNumber":123456789,
"gender":{
"code":"M",
"description":"Male"
},
"nationality":{
"code":"US",
"description":"United States"
},
"discountTemplate":{
"code":"LV1",
"description":"Disc Template 1 - 10%"
},
"reservationAccountReferenceId":12345,
"reservationStatus":{
"code":"CC",
"description":"Checked In"
},
"cabinNumber":12345,
"reservationAccountType":"C",
"onboardStatus":false,
"reservationCancelStatus":false,
"reservationBookingNumber":123456789,
"embarkationDate":"2015-09-02",
"actualEmbarkationTime":"07:30:00",
"actualEmbarkationDate":"2015-09-02",
"disembarkationDate":"2015-09-09",
"actualDisembarkationTime":"20:23:00",
"actualDisembarkationDate":"2015-09-09",
"boardCardNumber":"123456789",
"reservationId":12345,
"accountId":12345,
"embarkationHarbor":{
"code":"AGSJO",
"description":"ST JOHNS"
},
"disembarkationHarbor":{
"code":"AGSJO",
"description":"ST JOHNS"
},
"photo":"/Images/People/",
"musterStation":{
"code":"A",
"description":"Musterstation A"
},
"isNoticeAndConsent":false,
"crewOperationalDepartment":{
"code":120,
"description":"Deck"
},
"crewOperationalPosition":{
"code":106,
"description":"3rd Officer"
},
"crewManningNumber":"0002",
"safetyPosition":{
"code":"002",
"description":"Master"
},
"crewExternalId":"5566",
"crewInternalId":"5588",
"contactlessId":"abc456",
"locationAt":"ABC23",
"attendImmigrationInspection":1,
"skipImmigrationInspection":false
}
},
{
"links":{
"rel":"resident",
"href":"http://[HOSTNAME]/spms/v1/resident/12345",
"method":"get",
"operationId":"findByID"
},
"item":{
"profileId":12345,
"title":"Mr",
"salutation":"MR",
"firstName":"John",
"middleName":"Andy",
"lastName":"Smith",
"otherFirstName":null,
"otherLastName":null,
"dateOfBirth":"1961-04-01",
"age":57,
"accountCategory":"PAX",
"accountType":"P",
"nationalId":"123456789",
"passportNumber":"A01234567",
"passportIssuedDate":"1961-04-01",
"passportExpiryDate":"1961-04-01",
"passportIssuedCountry":{
"code":"US",
"description":"United States"
},
"passportIssuedPlace":"Paramount",
"birthNation":{
"code":"US",
"description":"United States"
},
"countryOfResidence":{
"code":"US",
"description":"United States"
},
"phoneNumber":123456789,
"temporaryPhoneNumber":123456789,
"emailAddress":"sample@mail.com",
"emergencyContactName":"John",
"emergencyContactNumber":123456789,
"gender":{
"code":"M",
"description":"Male"
},
"nationality":{
"code":"US",
"description":"United States"
},
"discountTemplate":{
"code":"LV1",
"description":"Disc Template 1 - 10%"
},
"reservationAccountReferenceId":12345,
"reservationStatus":{
"code":"CC",
"description":"Checked In"
},
"stateroomNumber":12345,
"reservationAccountType":"R",
"routedAccountNumber":12345,
"onboardStatus":false,
"reservationCancelStatus":false,
"reservationBookingNumber":123456789,
"embarkCruiseId":12345,
"embarkationDate":"2015-09-02",
"actualEmbarkationTime":"07:30:00",
"actualEmbarkationDate":"2015-09-02",
"disembarkationDate":"2015-09-09",
"actualDisembarkationTime":"20:23:00",
"actualDisembarkationDate":"2015-09-09",
"boardCardNumber":"123456789",
"reservationId":12345,
"accountId":12345,
"reservationExternalId":"12345",
"embarkationHarbor":{
"code":"AGSJO",
"description":"ST JOHNS"
},
"disembarkationHarbor":{
"code":"AGSJO",
"description":"ST JOHNS"
},
"groupReferenceId":12345,
"photo":"/Images/People/",
"classification":"CLASS I",
"setSailPass":12345,
"musterStation":{
"code":"A",
"description":"Musterstation A"
},
"groupName":"Smith",
"isNoticeAndConsent":false,
"contactlessId":"abc456",
"locationAt":"ABC23",
"attendImmigrationInspection":1,
"skipImmigrationInspection":false
}
},
{
"links":{
"rel":"visitor",
"href":"http://[HOSTNAME]/spms/v1/visitor/12345",
"method":"get",
"operationId":"findByID"
},
"item":{
"profileId":12345,
"title":"Mr",
"salutation":"MR",
"firstName":"John",
"middleName":"Andy",
"lastName":"Smith",
"dateOfBirth":"1961-04-01",
"age":57,
"accountType":"V",
"passportNumber":"A01234567",
"birthNation":{
"code":"US",
"description":"United States"
},
"countryOfResidence":{
"code":"US",
"description":"United States"
},
"phoneNumber":123456789,
"emailAddress":"sample@mail.com",
"emergencyContactName":"John",
"emergencyContactNumber":123456789,
"gender":{
"code":"M",
"description":"Male"
},
"nationality":{
"code":"US",
"description":"United States"
},
"reservationStatus":{
"code":"CC",
"description":"Checked In"
},
"reservationAccountType":"V",
"onboardStatus":false,
"reservationCancelStatus":false,
"embarkationDate":"2015-09-02",
"actualEmbarkationTime":"07:30:00",
"actualEmbarkationDate":"2015-09-02",
"disembarkationDate":"2015-09-09",
"actualDisembarkationTime":"20:23:00",
"actualDisembarkationDate":null,
"boardCardNumber":"123456789",
"reservationId":12345,
"accountId":12345,
"embarkationHarbor":{
"code":"AGSJO",
"description":"ST JOHNS"
},
"disembarkationHarbor":{
"code":"AGSJO",
"description":"ST JOHNS"
},
"photo":"/Images/People/",
"isNoticeAndConsent":false,
"visitorPassType":"DEC10",
"contactlessId":"abc456",
"locationAt":"ABC23",
"attendImmigrationInspection":1,
"skipImmigrationInspection":false
}
}
],
"limit":10,
"offset":0
}204 Response
No content is available
401 Response
You are not authorized to use this API
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
-
detail(optional):
string
Example:
There are validation errors for the object...... -
title(optional):
string
Example:
validation fails for row with key={123} -
type(optional):
string
Example:
HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1
403 Response
You are forbidden to use this API
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 was forbidden"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
-
detail(optional):
string
Example:
There are validation errors for the object...... -
title(optional):
string
Example:
validation fails for row with key={123} -
type(optional):
string
Example:
HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1
404 Response
Record not found
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.5",
"title":"Not Found",
"detail":"Ship 123 was not found"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
-
detail(optional):
string
Example:
There are validation errors for the object...... -
title(optional):
string
Example:
validation fails for row with key={123} -
type(optional):
string
Example:
HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1
405 Response
This method is not available
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
-
detail(optional):
string
Example:
There are validation errors for the object...... -
title(optional):
string
Example:
validation fails for row with key={123} -
type(optional):
string
Example:
HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1
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
-
detail(optional):
string
Example:
There are validation errors for the object...... -
title(optional):
string
Example:
validation fails for row with key={123} -
type(optional):
string
Example:
HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1
500 Response
Error occured while processing this 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.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
-
detail(optional):
string
Example:
There are validation errors for the object...... -
title(optional):
string
Example:
validation fails for row with key={123} -
type(optional):
string
Example:
HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1
503 Response
Service not available
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
-
detail(optional):
string
Example:
There are validation errors for the object...... -
title(optional):
string
Example:
validation fails for row with key={123} -
type(optional):
string
Example:
HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1