Retrieve a guest profile by guest Id
get
/spms/v2/ships/{shipId}/profiles/guests/{profileId}
This is to retrieve a guest profile by guest Id
Request
Supported Media Types
- application/json
Path Parameters
-
profileId(required): integer
Profile ID
-
shipId(required): number
Ship Id
Response
Supported Media Types
- application/hal+json
200 Response
OK
Root Schema : Guest Profile
Type:
objectTitle:
Guest ProfileGuest Profile Response
Show Source
-
_links:
object _links
Links
-
accountCategory:
string
Allowed Values:
[ "PAX" ]accountCategoryExample:PAX -
age:
integer(int32)
Minimum Value:
1Maximum Value:150AgeExample:25 -
awardLevel:
string
Maximum Length:
6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Award Level * `null` if emptyExample:platinium -
birthNation:
object birthNation
Birth Nation
-
birthPlace:
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Birth PlaceExample:Kajang -
classification:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9,.!? ]*$Classification * `null` if emptyExample:CLASS I -
contactDetails:
object contactDetails
Contact Details
-
dateOfBirth:
string(date)
Birth DateExample:
2018-11-11 -
finNumber:
string
Maximum Length:
20Pattern:^[a-zA-Z0-9 ]+?$FIN Number * `null` if emptyExample:a1234 -
firstName:
string
Minimum Length:
1Maximum Length:40The first name of the guestExample:Kobe -
frequentNumber:
string
Maximum Length:
60Pattern:^[a-zA-Z0-9 ]+?$Frequent Number * `null` if emptyExample:a1234 -
gender:
string
GenderExample:
Male -
guestId:
integer
Minimum Value:
0Guest IdExample:456789 -
intoxication:
boolean
Is the guest intoxicated: * `true` - Intoxicated * `false` - Non-intoxicatedExample:
false -
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 -
nationalId:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 ]*$National IdExample:22 -
nationality:
object nationalityStruct
Nationality
-
otherFirstName:
string
Minimum Length:
1Maximum Length:80Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$Other First Name * `null` if emptyExample:Frost -
otherLastName:
string
Minimum Length:
1Maximum Length:100Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$Other Last Name * `null` if emptyExample:Francis -
passportDetails:
object passportDetailsResponse
Passport Details
-
permanentResidentNumber:
string
Maximum Length:
30Pattern:^[a-zA-Z0-9 ]+?$Permanent Resident Number * `null` if emptyExample:a1234 -
photo:
string
PhotoExample:
/9j/4AAQSkZJRgABAQEASABIAAD== -
preferredLanguage:
object preferredLanguage
Preferred Language
-
profession:
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Profession * `null` if emptyExample:Sales Executive -
profileType:
string
Allowed Values:
[ "Guest", "Resident" ]Profile TypeExample:Resident -
resident:
boolean
Is the guest a resident: * `true` - resident * `false` - Not residentExample:
true -
royaltyNumber:
string
Maximum Length:
20Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Royalty NumberExample:a1234 -
salutation:
string
Minimum Length:
1Maximum Length:20The salutation of the guestExample:Mr. -
smoker:
boolean
Is the guest a smoker: * `true` - Smoker * `false` - Non-smokerExample:
false -
title:
string
Minimum Length:
1Maximum Length:20Pattern:^[ A-Za-z0-9,'_@./#&+-]*$TitleExample:MR -
vip:
object VIP
VIP
Nested Schema : _links
Type:
objectLinks
Show Source
-
self:
object homeAddressLink
Home Address Link (relation)
Nested Schema : birthNation
Type:
objectBirth Nation
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Birth Nation Code * `null` if emptyExample:US -
description:
string
Birth Nation Name * `null` if emptyExample:
United States
Nested Schema : contactDetails
Type:
objectContact Details
Show Source
-
alternativeNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[0-9+-]*$Temporary Phone Number * `null` if emptyExample:4413563590 -
emailAddress:
string
Minimum Length:
1Maximum Length:49Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$Email Address * `null` if emptyExample:abby@mail.com -
emergencyContactMobileNumber:
string
Minimum Length:
1Maximum Length:30Pattern:^[0-9+-]*$Emergency Contact Mobile Phone Number * `null` if emptyExample:0173443434 -
emergencyContactName:
string
Minimum Length:
1Maximum Length:100Pattern:^[a-zA-Z0-9 ]+?$Emergency Contact Name * `null` if emptyExample:Emmeline -
emergencyContactPhoneNumber:
string
Minimum Length:
1Maximum Length:30Pattern:^[0-9+-]*$Emergency Contact Phone Number * `null` if emptyExample:+6239629999 -
mobileNumber:
string
Minimum Length:
1Maximum Length:30Pattern:^[0-9+-]*$Mobile Number * `null` if emptyExample:62-39629630
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 : nationalityStruct
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 : passportDetailsResponse
Type:
objectPassport Details
Show Source
-
passportExpiryDate:
string(ISO 8601)
Passport Expiry DateExample:
2009-10-31 -
passportIssuedCountry:
object passportIssuedCountry
Passport Issued Country
-
passportIssuedDate:
string(date)
Passport Issued DateExample:
2018-11-11 -
passportIssuedPlace:
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Passport Issued PlaceExample:Shah Alam -
passportNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 ]+?$Passport NumberExample:A145611
Nested Schema : preferredLanguage
Type:
objectPreferred Language
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z_0-9-! ]+$Preferred Language CodeExample:EN -
description:
string
Preferred Language DescriptionExample:
English
Nested Schema : VIP
Type:
objectVIP
Show Source
-
code:
string
Maximum Length:
6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$VIP CodeExample:S/VIP -
description:
string
VIP DescriptionExample:
SUPERVIP
Nested Schema : homeAddressLink
Type:
objectHome Address Link (relation)
Show Source
-
href:
string
Example:
http://[HOSTNAME]/spms/v2/ships/186000000117/profile/1001/addresses/home -
method:
string
Example:
get -
operationId:
string
Example:
getHomeAddress
Nested Schema : passportIssuedCountry
Type:
objectPassport Issued Country
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Passport Issued Country CodeExample:MY -
description:
string
Passport Issued Country Code DescriptionExample:
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 'profileId' 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":"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:
{
"title":"Not Found",
"type":"https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
"detail":"Ship 186000000404 was not 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 Allowed",
"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
410 Response
Gone
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.11",
"title":"Gone",
"detail":"Requested Resource no longer exists"
}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:
{
"title":"Invalid content",
"type":"https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
"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":"https://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":"https://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