GET users/list
Returns a collection of the users on the authorized user’s account.
Resource URL
Resource Information
Required scope
|
read_actions |
Required role
|
Media manager |
Response formats
|
JSON, XML |
Requires authentication?
|
Yes |
Parameters
since
optional
|
Returns results with an ID greater than (that is, more recent than) the specified ID. |
until
optional
|
Returns results with an ID less than (that is, older than) the specified ID. |
count
optional
|
Specifies the number of records to retrieve. Must be less than or equal to 100; defaults to 15. |
user_ids
optional
|
Specifies a comma-separated list of the user ID(s) for the resource(s) that are being retrieved. |
Example Request
Example Result
{ "users":{ "user":[ { "id":"da7b97fd29631e11", "name":"Alex Zang", "short_name":"AZ", "first_name":"Alex", "last_name":"Zang", "thumbnail":"\/\/d1teylh2i3wa1w.cloudfront.net\/users\/avatar_3f564108bc3fd5f4912d99dfb5cb09f24210f77a_normal.jpg", "photo":"", "timezone":"Europe\/London", "date_format":"d\/m\/Y", "created_at":"2014-06-29T11:28:08+00:00" }, { "id":"75d4533191ca6bc3", "name":"Staff ZiMovi", "short_name":"SZ", "first_name":"Staff", "last_name":"ZiMovi", "thumbnail":"\/\/d1teylh2i3wa1w.cloudfront.net\/users\/avatar_47f9595fa695065d26f2f97cd14851c2f50e8436_normal.png", "photo":"\/\/d1teylh2i3wa1w.cloudfront.net\/users\/avatar_47f9595fa695065d26f2f97cd14851c2f50e8436_large.png", "timezone":"Europe\/London", "date_format":"d\/m\/Y", "created_at":"2014-05-21T16:39:05+00:00" } ] }, "metadata":{ "total":"2", "count":15, "since":null, "until":null } }