JSON API » queues » queues/events/list

Gets the fields of queue events. These have only been collected if the queue is set to do so.

Input parameters

Requires authentication and the user role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
queueIntegerID of queue to get events for.Yes
startIntegerStart Unix timestamp. -1 for the last time this function was called for this queue.No-1
endIntegerEnd Unix timestamp. -1 for one second ago.No-1

Responses

CodeDescription
200Success.
400Invalid input parameters specified. Check the key and message fields for more details.
401The authentication details provided are invalid.
402Your role does not allow this.
404The queue does not exist, or you do not have permission to view it.

Data returned

An array of fields, corresponding to the recorded queue events.

Example: With required parameters (data truncated for brevity)

http://enswitch.example.com/api/json/queues/events/list/?auth_username=user;auth_password=password;queue=123

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":[ { "data":"1234567890|NONE|..." }, { "data":"1234567891|NONE|..." } ] }

Change history

VersionChanges
3.13Function added.