Retrieve a crew profile by profile Id
get
/spms/v2/ships/{shipId}/profiles/crews/{profileId}
This is to retrieve a crew profile by profile 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 : Crew Profile
Type:
object
Title:
Crew Profile
Crew Profile Response
Show Source
-
accountCategory:
string
accountCategoryExample:
CRW
-
age:
integer(int32)
Minimum Value:
1
Maximum Value:150
AgeExample:25
-
birthNation:
object cpBirthNation
Birth Nation
-
birthPlace:
string
Birth Place * `null` if emptyExample:
KL
-
dateOfBirth:
string(ISO 8601 (YYYY-MM-DD))
Date Of BirthExample:
1999-02-15
-
eyeColour:
string
Minimum Length:
0
Maximum Length:20
Eye ColourExample:Blue
-
finNumber:
string
Minimum Length:
0
Maximum Length:20
FIN NumberExample:B123
-
firstName:
string
Minimum Length:
1
Maximum Length:40
First NameExample:Down
-
gender:
string
Pattern:
^[ A-Za-z0-9,'_@./#&+-]*$
GenderExample:M
-
hairColour:
string
Minimum Length:
0
Maximum Length:20
Hair ColourExample:Blonde
-
height:
string
Minimum Length:
0
Maximum Length:10
HeightExample:190
-
intoxication:
boolean
Is the guest intoxicated: * `true` - Intoxicated * `false` - Non-intoxicatedExample:
true
-
lastName:
string
Minimum Length:
1
Maximum Length:40
Last NameExample:Niel
-
links:
array links
-
maritalStatus:
object maritalStatus
Marital Status
-
middleName:
string
Minimum Length:
1
Maximum Length:30
Middle Name * `null` if emptyExample:MB
-
nationalId:
string
Minimum Length:
1
Maximum Length:20
National Id * `null` if emptyExample:A123
-
nationality:
object cpNationalityStruct
Nationality
-
nationalityFlag:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Nationality FlagExample:US
-
otherFirstName:
string
Minimum Length:
1
Maximum Length:80
Other First Name * `null` if emptyExample:null
-
otherLastName:
string
Minimum Length:
1
Maximum Length:100
Other Last Name * `null` if emptyExample:null
-
passportDetails:
object passportDetailsResponse
Passport Details
-
photo:
string
PhotoExample:
https://example.com/resources/crew.jpg
-
preferredLanguage1:
object preferredLanguage
Preferred Language
-
preferredLanguage2:
object preferredLanguage
Preferred Language
-
preferredLanguage3:
object preferredLanguage
Preferred Language
-
privilegeLevel:
integer
Minimum Value:
0
Maximum Value:1
Privilege Level * `null` if emptyExample:1
-
profileId:
integer
Minimum Value:
0
Profile IdExample:456789
-
profileType:
string
Profile TypeExample:
C
-
salutation:
string
SalutationExample:
Mr.
-
seamanBookDetails:
object seamanBookDetailsResponse
Seaman Book Details
-
smoke:
boolean
Is the guest a smoker: * `true` - Smoker * `false` - Non-smokerExample:
true
-
weight:
number
WeightExample:
70
Nested Schema : cpBirthNation
Type:
object
Birth Nation
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:3
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Birth Nation Code * `null` if emptyExample:US
-
description:
string
Birth Nation Name * `null` if emptyExample:
United States
Nested Schema : links
Type:
Show Source
array
-
Array of:
object cpLinksProfile
Links Detail
Example:
[
{
"href":"http://[HOSTNAME]/spms/v2/ships/186000000117/profiles/crews/1001/crewEmployments",
"method":"get",
"operationId":"getCrewEmployment"
},
{
"href":"http://[HOSTNAME]/spms/v2/ships/186000000117/profiles/crew/1001/crewSafetyAssignments",
"method":"get",
"operationId":"getCrewSafetyAssignment"
},
{
"href":"http://[HOSTNAME]/spms/v2/ships/186000000117/profile/1001/addresses/home",
"method":"get",
"operationId":"getHomeAddress"
},
{
"href":"http://[HOSTNAME]/spms/v2/ships/186000000117/profile/1001/addresses/emergencyContact ",
"method":"get",
"operationId":"getEmergencyContact"
}
]
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 : cpNationalityStruct
Type:
object
Nationality
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Country CodeExample:MY
-
description:
string
Country NameExample:
Malaysia
Nested Schema : passportDetailsResponse
Type:
object
Passport Details
Show Source
-
passportExpiryDate:
string(ISO 8601)
Passport Expiry DateExample:
2019-10-31
-
passportIssuedCountry:
object passportIssuedCountry
Passport Issued Country
-
passportIssuedDate:
string(ISO 8601)
Passport Issued DateExample:
2009-10-31
-
passportIssuedPlace:
string
Maximum Length:
50
Passport Issued PlaceExample:Shah Alam
-
passportNumber:
string
Maximum Length:
20
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Passport NumberExample:ABC12345678
Nested Schema : preferredLanguage
Type:
object
Preferred Language
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Preferred Language CodeExample:EN
-
description:
string
Preferred Language DescriptionExample:
English
Nested Schema : seamanBookDetailsResponse
Type:
object
Seaman Book Details
Show Source
-
seamanBookExpiredDate:
string(ISO 8601)
Seaman Book Expired DateExample:
2009-10-31
-
seamanBookIssuedCountry:
object seamanBookIssuedCountry
Passport Issued Country
-
seamanBookIssuedDate:
string(ISO 8601)
Seaman Book Issued DateExample:
2009-10-31
-
seamanBookIssuedPlace:
string
Minimum Length:
1
Maximum Length:50
Passport Issued PlaceExample:Kuala Lumpur
-
seamanBookNumber:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Seaman Book NumberExample:ABC12345678
Nested Schema : cpLinksProfile
Type:
object
Links Detail
Show Source
-
method:
string
Example:
get
-
rel:
string
Example:
self
Nested Schema : passportIssuedCountry
Type:
object
Passport Issued Country
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
Country CodeExample:MY
-
description:
string
Country NameExample:
Malaysia
Nested Schema : seamanBookIssuedCountry
Type:
object
Passport Issued Country
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ 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 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":"The parameter 'profileId' has incorrect format"
}
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:
{
"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:
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 Allowed",
"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:
{
"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:
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":"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:
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":"https://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