GET users/list
Returns a collection of the users on the authorized user’s account.
Resource URL
https://zimovi.com/api/users/list.json (or .xml)
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
GET https://zimovi.com/api/users/list.json?user_ids=75d4533191ca6bc3,da7b97fd29631e11
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
}
}