Get Members
Gets members (100 members per page).
It returns an empty list if the requested page contains no members.
It is available only when Organization Sync > Setting for use of Get Members API is set to On in the Developer Console.
API Type
Server API
Request URL
https://apis.worksmobile.com/r/{API ID}/organization/v2/domains/{domainId}/users
HTTP Method
GET
Path Parameters
Parameter | Type | Length | Required | Description |
---|---|---|---|---|
domainId | Integer | Y | The primary position's domain ID |
Request Parameters
Parameter | Type | Length | Required | Description |
---|---|---|---|---|
page | Integer | Y | Page |
Request Example
GET https://apis.worksmobile.com/r/apiid/organization/v2/domains/123/users?page=1
Response
Property | Type | Description |
---|---|---|
externalKey | String | External key of the member |
String | Account. Member's email address for the Basic and Premium products. id@group name for the Lite product. |
|
name | String | Member name |
authority | String | Member authority • MASTER: Admin • MANEGER: Sub Admin • MEMBER: Member |
organizations[] | List | List of domains (companies) to which the member belongs (including both the primary and secondary positions) |
organizations[].domainId | Integer | Domain ID |
organizations[].levelName | String | Level name |
organizations[].orgUnits[] | List | List of organizations that belong to the domain ID |
organizations[].orgUnits[].domainId | Integer | Domain ID of the organization |
organizations[].orgUnits[].name | String | Organization name |
organizations[].orgUnits[].represent | Boolean | Indicates whether it is the default organization. |
organizations[].orgUnits[].positionName | String | Position name |
organizations[].orgUnits[].display | Boolean | Indicates whether to show the organization. |
Response Example
[
{
"externalKey": "TEST001",
"email": "admin@test.com",
"name": "ADMIN",
"authority": "MASTER",
"organizations": [
{
"domainId": 1,
"orgUnits": [],
"levelName": "LVL"
}
]
},
{
"externalKey": "ABC",
"email": "abc@test.com",
"name": "ABC",
"authority": "MEMBER",
"organizations": [
{
"domainId": 1,
"orgUnits": [
{
"domainId": 1,
"name": "ORG1",
"represent": true,
"positionName": "Position1",
"display": true
},
{
"domainId": 1,
"name": "ORG2",
"represent": false,
"positionName": "Position2",
"display": true
}
],
"levelName": "Level"
}
]
}
]
Error Code
It returns an error code and message when the API call fails.
Refer to Organization Integration REST API Error Codes for details.