Retrieve user groups
get
/spms/v2/ships/{shipId}/roleManagers/userGroups
This is to retrieve user groups
Request
Supported Media Types
- application/json
Path Parameters
-
shipId(required): number
ship Id
Query Parameters
-
isActive: boolean
Minimum Value:
0
Activation status of the user group: * `true` - User group is active * `false` - User group is inactive -
limit: integer(int32)
Minimum Value:
0
Paging limit -
offset: integer(int32)
Minimum Value:
0
Paging offset -
orderBy: string
Minimum Value:
0
order by userGroupCode with format column1:asc/desc,column2:asc/desc -
searchValue: string
Search value
-
userGroupCode: string
User group code
-
userGroupDescription: string
User group description
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : List of User Groups
Type:
object
Title:
List of User Groups
List of User Groups
Show Source
-
count:
integer
Example:
12345678
-
hasMore:
boolean
Example:
true
-
items:
array items
-
limit:
integer
Example:
10
-
offset:
integer
Example:
1
Nested Schema : items
Type:
Show Source
array
-
Array of:
object User Groups
Title:
User Groups
User Groups
Example:
[
{
"userGroupId":"1",
"userGroupCode":"Admin",
"userGroupDescription":"Administration",
"isActive":true
},
{
"userGroupId":"2",
"userGroupCode":"Agent",
"userGroupDescription":"Checkin Agent",
"isActive":true
}
]
Nested Schema : User Groups
Type:
object
Title:
User Groups
User Groups
Show Source
-
isActive:
boolean
Activation status of the sub department: * `true` - Sub Department is active * `false` - Sub Department is inactiveExample:
true
-
userGroupCode:
string
Maximum Length:
6
Pattern:^[a-zA-ZÀ-ÖØ-öø--9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
User Group CodeExample:Admin
-
userGroupDescription:
string
Pattern:
^[a-zA-ZÀ-ÖØ-öø--9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
User Group DescriptionExample:Administration
-
userGroupId:
integer
Minimum Value:
1
Pattern:^[0-9]*$
User Group IDExample:1001
204 Response
No Content
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":"Limit must not be less than one!"
}
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":"https://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
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
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
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 Unavailable. Try again later"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source