/api/domains/:domain_id/users
List users for domain specified by domain ID.
This resource is available only for Global admin or Domain admin.
Resource Information
Resource URL | |
---|---|
HTTP Method | GET |
Request Parameters
Parameter | Detail | Example |
---|---|---|
domain_id | Domain identifier | 123 |
Response Structure
JSON response contains array "users" that contains multiple user objects with following definition:
Name | Description | ||||||
---|---|---|---|---|---|---|---|
id | User identifier | ||||||
username | Username | ||||||
domain_id | Domain identifier | ||||||
firstName | User first name | ||||||
lastName | User last name | ||||||
User email address | |||||||
active | Boolean flag indicating if user is active | ||||||
info | User detail information | ||||||
firstLogin | Date and time of user's first login | ||||||
lastLogin | Date and time of user's last login | ||||||
phone | User phone number | ||||||
timeZone | User time zone | ||||||
locale | User locale - code of supported language | ||||||
roles | Array containing all user roles where each role has following structure:
| ||||||
groups | Array containing all user groups where user belongs. Each group has following structure:
|
Sample Request / Response
Using curl
:
curl -H "Authorization: OAuth realm=\"https://service.belladati.com/\", oauth_consumer_key=\"myConsumer\", oauth_token=\"mh7an9dkrg59\", oauth_timestamp=\"135131231\", oauth_nonce=\"randomString\"" https://service.belladati.com/api/domains/123/users
The JSON format response:
{ "users": [ { "id": "222", "username": "myusername@example.com", "domain_id": "123", "firstName": "John", "lastName": "Doe", "email": "myusername@example.com", "active": true, "info": "I'm pretty cool", "firstLogin": "Thu, 14 Jan 2012 15:33:28 GMT", "lastLogin": "Tue, 12 Apr 2016 11:40:58 GMT", "phone": "(555) 123 456 789", "timeZone": "Europe/Prague", "locale": "cs", "roles": [ { "role": "WORKSPACE_ADMIN" } ], "groups": [ { "id": "56", "name": "My User Group nr.1" } ] }, { "id": "345", "username": "fooUsername", "domain_id": "123", "firstName": "Adam", "lastName": "Sandleros", "email": "sandleros@example.com", "active": false, "info": null, "firstLogin": "Thu, 14 Jan 2012 15:33:28 GMT", "lastLogin": "Tue, 31 Mar 2016 11:40:58 GMT", "phone": null, "timeZone": null, "locale": "en", "roles": [], "groups": [] } ] }
Overview
Content Tools