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: integer
Profile ID
-
shipId: 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(optional):
object _links
Links
-
accountCategory(optional):
object accountCategory
Account Category
-
age(optional):
integer(int32)
Minimum Value:
1Maximum Value:150AgeExample:25 -
awardLevel(optional):
string
Maximum Length:
6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$Award Level * `null` if emptyExample:platinium -
birthNation(optional):
object birthNation
Birth Nation
-
birthPlace(optional):
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Birth Place * `null` if emptyExample:KL -
classification(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9,.!? ]*$Classification * `null` if emptyExample:CLASS I -
contactDetails(optional):
object contactDetails
Contact Details
-
dateOfBirth(optional):
string(ISO 8601 (YYYY-MM-DD))
Date of BirthExample:
1970-02-15 -
finNumber(optional):
string
Maximum Length:
20Pattern:^[a-zA-Z0-9 ]+?$FIN Number * `null` if emptyExample:a1234 -
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 -
frequentNumber(optional):
string
Maximum Length:
60Pattern:^[a-zA-Z0-9 ]+?$Frequent Number * `null` if emptyExample:a1234 -
gender(optional):
string
GenderExample:
Male -
guestId(optional):
integer
Minimum Value:
0Guest IdExample:456789 -
intoxication(optional):
boolean
Is the guest intoxicated: * `true` - Intoxicated * `false` - Non-intoxicatedExample:
false -
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 -
maritalStatus(optional):
object maritalStatus
Marital Status
-
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 -
nationalId(optional):
string
Maximum Length:
20Pattern:^[a-zA-Z0-9 ]+?$National Id * `null` if emptyExample:1234 -
nationality(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 -
otherFirstName(optional):
string
Other First NameExample:
Mäya -
otherLastName(optional):
string
Other Last NameExample:
Wälters -
passportDetails(optional):
object passportDetailsResponse
Passport Details
-
permanentResidentNumber(optional):
string
Maximum Length:
30Pattern:^[a-zA-Z0-9 ]+?$Permanent Resident Number * `null` if emptyExample:a1234 -
photo(optional):
string
PhotoExample:
https://[HOSTNAME]/resources/img_01.jpg -
preferredLanguage(optional):
object preferredLanguage
Preferred Language
-
profession(optional):
string
Maximum Length:
50Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Profession * `null` if emptyExample:Sales Executive -
profileType(optional):
string
Allowed Values:
[ "Guest", "Resident" ]Profile TypeExample:Resident -
resident(optional):
boolean
Is the guest a resident: * `true` - resident * `false` - Not residentExample:
true -
royaltyNumber(optional):
string
Maximum Length:
20Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Royalty Number * `null` if emptyExample:a1234 -
salutation(optional):
string
SalutationExample:
Dr. -
smoker(optional):
boolean
Is the guest a smoker: * `true` - Smoker * `false` - Non-smokerExample:
false -
title(optional):
string
TitleExample:
Countess -
vip(optional):
object VIP
VIP
Nested Schema : _links
Type:
objectLinks
Show Source
-
self(optional):
object homeAddressLink
Home Address Link (relation)
Nested Schema : accountCategory
Type:
objectAccount Category
Show Source
-
code(optional):
string
Minimum Value:
1Maximum Value:6Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$Account Category codeExample:PROLOS -
description(optional):
string
Account Category DescriptionExample:
Regular Guest
Nested Schema : birthNation
Type:
objectBirth Nation
Show Source
-
code(optional):
string
Minimum Length:
1Maximum Length:3Pattern:^[ A-Za-z0-9_@./#&+-]*$Country CodeExample:US -
description(optional):
string
Birth Nation Name * `null` if emptyExample:
United States
Nested Schema : contactDetails
Type:
objectContact Details
Show Source
-
alternativeNumber(optional):
string
Minimum Length:
1Maximum Length:20Pattern:^[0-9+-]*$Temporary Phone Number * `null` if emptyExample:4413563590 -
emailAddress(optional):
string
Minimum Length:
1Maximum Length:49Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$Email Address * `null` if emptyExample:abby@mail.com -
emergencyContactMobileNumber(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^[0-9+-]*$Emergency Contact Mobile Phone Number * `null` if emptyExample:0173443434 -
emergencyContactName(optional):
string
Minimum Length:
1Maximum Length:100Pattern:^[a-zA-Z0-9 ]+?$Emergency Contact Name * `null` if emptyExample:Emmeline -
emergencyContactPhoneNumber(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^[0-9+-]*$Emergency Contact Phone Number * `null` if emptyExample:+6239629999 -
mobileNumber(optional):
string
Minimum Length:
1Maximum Length:30Pattern:^[0-9]*$Mobile Number * `null` if emptyExample:4413563590
Nested Schema : maritalStatus
Type:
objectMarital Status
Show Source
-
code(optional):
object maritalStatusCode
maritalStatusCode
-
description(optional):
string
Marital Status DescriptionExample:
Single
Nested Schema : passportDetailsResponse
Type:
objectPassport Details
Show Source
-
passportExpiryDate(optional):
string(ISO 8601 (YYYY-MM-DD))
Passport Expiry DateExample:
2025-02-25 -
passportIssuedCountry(optional):
object passportIssuedCountry
Passport Issued Country
-
passportIssuedDate(optional):
string(ISO 8601)
Passport Issued DateExample:
2009-10-31 -
passportIssuedPlace(optional):
string
Passport Issued PlaceExample:
Paramount -
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
Nested Schema : preferredLanguage
Type:
objectPreferred Language
Show Source
-
code(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z_0-9-! ]+$Preferred Language CodeExample:EN -
description(optional):
string
Preferred Language DescriptionExample:
English
Nested Schema : VIP
Type:
objectVIP
Show Source
-
code(optional):
string
Maximum Length:
6Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$VIP CodeExample:S/VIP -
description(optional):
string
VIP DescriptionExample:
SUPERVIP
Nested Schema : homeAddressLink
Type:
objectHome Address Link (relation)
Show Source
-
href(optional):
string
Example:
http://[HOSTNAME]/spms/v2/ships/186000000117/profile/1001/addresses/home -
method(optional):
string
Example:
get -
operationId(optional):
string
Example:
getHomeAddress
Nested Schema : maritalStatusCode
Type:
objectmaritalStatusCode
Show Source
-
code(optional):
string
Minimum Length:
1Maximum Length:6Pattern:^[a-zA-Z0-9 ]{1,6}$Marital Status CodeExample:D -
comments(optional):
string
Maximum Value:
4000Account Category CommentsExample:The term profit and loss (P&L) statement refers to a financial statement that summarizes the revenues, costs, and expenses incurred during a specified period, usually a quarter or fiscal year. These records provide information about a companys ability or inability to generate profit by increasing revenue, reducing costs, or both. These statements are often presented on a cash or accrual basis. -
description(optional):
string
Minimum Value:
1Maximum Value:1000Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$Account Category DescriptionExample:Profit and Loss Account -
id(optional):
string
Minimum Length:
1Maximum Length:10Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$Currency Exchange IdExample:12345 -
isEnabled(optional):
boolean
This is to indicate switch to enable / disable account category (default value: true) * `true` - Enable account category * `false` - Disable account categoryExample:
true
Nested Schema : passportIssuedCountry
Type:
objectPassport Issued Country
Show Source
-
code(optional):
string
Minimum Length:
1Maximum Length:6Country Code * `null` if emptyExample:US -
description(optional):
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 '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