Update a guest or resident profile by guest Id
put
/spms/v2/ships/{shipId}/profiles/guests/{profileId}
This is to update a new guest or resident profile details by guest Id
Request
Supported Media Types
- application/json
Path Parameters
-
profileId(required): integer
Profile Id
-
shipId(required): number
Ship Id
Guest Profile Object
Root Schema : Guest Profile Request
Type:
object
Title:
Guest Profile Request
Guest Profile Request Body
Show Source
-
accountCategory:
string
Allowed Values:
[ "PAX" ]
accountCategoryExample:PAX
-
age:
integer(int32)
Minimum Value:
1
Maximum Value:150
AgeExample:25
-
awardLevel:
string
Maximum Length:
6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Award Level * `null` if emptyExample:platinium
-
birthNation:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Birth Nation Code * `null` if emptyExample:US
-
birthPlace:
string
Maximum Length:
50
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Birth PlaceExample:Kajang
-
classification:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[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:
20
Pattern:^[a-zA-Z0-9 ]+?$
FIN Number * `null` if emptyExample:a1234
-
firstName:
string
Minimum Length:
1
Maximum Length:40
The first name of the guestExample:Kobe
-
frequentNumber:
string
Maximum Length:
60
Pattern:^[a-zA-Z0-9 ]+?$
Frequent Number * `null` if emptyExample:a1234
-
gender:
string
Pattern:
^F|M$
Gender Code * `F` - Female * `M` - MaleExample:M
-
intoxication:
boolean
Is the guest intoxicated: * `true` - Intoxicated * `false` - Non-intoxicatedExample:
false
-
lastName:
string
Minimum Length:
1
Maximum Length:40
The last name of the guestExample:James
-
maritalStatus:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Marital Status CodeExample:S
-
middleName:
string
Minimum Length:
1
Maximum Length:20
The middle name of the guestExample:Bean
-
nationalId:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[a-zA-Z0-9 ]*$
National IdExample:22
-
nationality:
string
Country CodeExample:
US
-
otherFirstName:
string
Minimum Length:
1
Maximum Length:80
Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$
Other First Name * `null` if emptyExample:Frost
-
otherLastName:
string
Minimum Length:
1
Maximum Length:100
Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$
Other Last Name * `null` if emptyExample:Francis
-
passportDetails:
object passportDetailsRequest
Passport Details
-
permanentResidentNumber:
string
Maximum Length:
30
Pattern:^[a-zA-Z0-9 ]+?$
Permanent Resident Number * `null` if emptyExample:a1234
-
photo:
string
PhotoExample:
/9j/4AAQSkZJRgABAQEASABIAAD==
-
preferredLanguage:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z_0-9-! ]+$
Preferred Language CodeExample:EN
-
profession:
string
Maximum Length:
50
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Profession * `null` if emptyExample:Sales Executive
-
profileType:
string
Pattern:
[PR]$
Profile Type Code * `P` - Guest * `R` - ResidentExample:R
-
resident:
boolean
Is the guest a resident: * `true` - resident * `false` - Not residentExample:
true
-
royaltyNumber:
string
Maximum Length:
20
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Royalty NumberExample:a1234
-
salutation:
string
Minimum Length:
1
Maximum Length:20
The salutation of the guestExample:Mr.
-
smoker:
boolean
Is the guest a smoker: * `true` - Smoker * `false` - Non-smokerExample:
false
-
title:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
TitleExample:MR
-
vip:
string
Nested Schema : contactDetails
Type:
object
Contact Details
Show Source
-
alternativeNumber:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[0-9+-]*$
Temporary Phone Number * `null` if emptyExample:4413563590
-
emailAddress:
string
Minimum Length:
1
Maximum Length:49
Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$
Email Address * `null` if emptyExample:abby@mail.com
-
emergencyContactMobileNumber:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[0-9+-]*$
Emergency Contact Mobile Phone Number * `null` if emptyExample:0173443434
-
emergencyContactName:
string
Minimum Length:
1
Maximum Length:100
Pattern:^[a-zA-Z0-9 ]+?$
Emergency Contact Name * `null` if emptyExample:Emmeline
-
emergencyContactPhoneNumber:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[0-9+-]*$
Emergency Contact Phone Number * `null` if emptyExample:+6239629999
-
mobileNumber:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[0-9+-]*$
Mobile Number * `null` if emptyExample:62-39629630
Nested Schema : passportDetailsRequest
Type:
object
Passport Details
Show Source
-
passportExpiryDate:
string(ISO 8601)
Passport Expiry DateExample:
2009-10-31
-
passportIssuedCountry:
string
Country CodeExample:
US
-
passportIssuedDate:
string(date)
Passport Issued DateExample:
2018-11-11
-
passportIssuedPlace:
string
Maximum Length:
50
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Passport Issued PlaceExample:Shah Alam
-
passportNumber:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[a-zA-Z0-9 ]+?$
Passport NumberExample:A145611
Response
Supported Media Types
- application/hal+json
200 Response
OK
Root Schema : Guest Profile
Type:
object
Title:
Guest Profile
Guest Profile Response
Show Source
-
_links:
object _links
Links
-
accountCategory:
string
Allowed Values:
[ "PAX" ]
accountCategoryExample:PAX
-
age:
integer(int32)
Minimum Value:
1
Maximum Value:150
AgeExample:25
-
awardLevel:
string
Maximum Length:
6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Award Level * `null` if emptyExample:platinium
-
birthNation:
object birthNation
Birth Nation
-
birthPlace:
string
Maximum Length:
50
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Birth PlaceExample:Kajang
-
classification:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[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:
20
Pattern:^[a-zA-Z0-9 ]+?$
FIN Number * `null` if emptyExample:a1234
-
firstName:
string
Minimum Length:
1
Maximum Length:40
The first name of the guestExample:Kobe
-
frequentNumber:
string
Maximum Length:
60
Pattern:^[a-zA-Z0-9 ]+?$
Frequent Number * `null` if emptyExample:a1234
-
gender:
string
GenderExample:
Male
-
guestId:
integer
Minimum Value:
0
Guest IdExample:456789
-
intoxication:
boolean
Is the guest intoxicated: * `true` - Intoxicated * `false` - Non-intoxicatedExample:
false
-
lastName:
string
Minimum Length:
1
Maximum Length:40
The last name of the guestExample:James
-
maritalStatus:
object maritalStatus
Marital Status
-
middleName:
string
Minimum Length:
1
Maximum Length:20
The middle name of the guestExample:Bean
-
nationalId:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[a-zA-Z0-9 ]*$
National IdExample:22
-
nationality:
object nationalityStruct
Nationality
-
otherFirstName:
string
Minimum Length:
1
Maximum Length:80
Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$
Other First Name * `null` if emptyExample:Frost
-
otherLastName:
string
Minimum Length:
1
Maximum Length:100
Pattern:^[ a-zA-Z0-9_.À-Ⰰ-]*$
Other Last Name * `null` if emptyExample:Francis
-
passportDetails:
object passportDetailsResponse
Passport Details
-
permanentResidentNumber:
string
Maximum Length:
30
Pattern:^[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:
50
Pattern:^[ 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:
20
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Royalty NumberExample:a1234
-
salutation:
string
Minimum Length:
1
Maximum Length:20
The salutation of the guestExample:Mr.
-
smoker:
boolean
Is the guest a smoker: * `true` - Smoker * `false` - Non-smokerExample:
false
-
title:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
TitleExample:MR
-
vip:
object VIP
VIP
Nested Schema : _links
Type:
object
Links
Show Source
-
self:
object homeAddressLink
Home Address Link (relation)
Nested Schema : birthNation
Type:
object
Birth Nation
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ 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:
object
Contact Details
Show Source
-
alternativeNumber:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[0-9+-]*$
Temporary Phone Number * `null` if emptyExample:4413563590
-
emailAddress:
string
Minimum Length:
1
Maximum Length:49
Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$
Email Address * `null` if emptyExample:abby@mail.com
-
emergencyContactMobileNumber:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[0-9+-]*$
Emergency Contact Mobile Phone Number * `null` if emptyExample:0173443434
-
emergencyContactName:
string
Minimum Length:
1
Maximum Length:100
Pattern:^[a-zA-Z0-9 ]+?$
Emergency Contact Name * `null` if emptyExample:Emmeline
-
emergencyContactPhoneNumber:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[0-9+-]*$
Emergency Contact Phone Number * `null` if emptyExample:+6239629999
-
mobileNumber:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[0-9+-]*$
Mobile Number * `null` if emptyExample:62-39629630
Nested Schema : maritalStatus
Type:
object
Marital Status
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
Marital Status CodeExample:S
-
description:
string
Marital Status DescriptionExample:
Single
Nested Schema : nationalityStruct
Type:
object
Nationality
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Nationality CodeExample:MY
-
description:
string
Nationality Code DescriptionExample:
Malaysia
Nested Schema : passportDetailsResponse
Type:
object
Passport 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:
50
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Passport Issued PlaceExample:Shah Alam
-
passportNumber:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[a-zA-Z0-9 ]+?$
Passport NumberExample:A145611
Nested Schema : preferredLanguage
Type:
object
Preferred Language
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[a-zA-Z_0-9-! ]+$
Preferred Language CodeExample:EN
-
description:
string
Preferred Language DescriptionExample:
English
Nested Schema : VIP
Type:
object
VIP
Show Source
-
code:
string
Maximum Length:
6
Pattern:^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
VIP CodeExample:S/VIP
-
description:
string
VIP DescriptionExample:
SUPERVIP
Nested Schema : homeAddressLink
Type:
object
Home 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:
object
Passport Issued Country
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ 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 Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Bad Request",
"detail":"Malformed JSON request"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
401 Response
Unauthorized
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
403 Response
Forbidden
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
404 Response
Not Found
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
"title":"Not Found",
"detail":"Profile ID - 1002 is invalid"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
405 Response
Method Not Allowed
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
406 Response
Not Acceptable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
410 Response
Gone
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
415 Response
Unsupported Media Type
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
500 Response
Internal Server Error
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
501 Response
Not Implemented
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
503 Response
Service Unavailable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source