JSON API » people » people/search/list

Gets the fields of all people recursively. This function is rarely used; people/list should normally be used instead.

Input parameters

Requires authentication and the user reports role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
pseudoInteger1 to include pseudo-users, 0 not to.No0
roleIntegerOnly return people with this role ID. 0 for any.No0
sortStringField to sort by. "customer_name", "description", "failed_count", "last_login", "role_name", or "username".No"username"
descendingInteger1 to sort descending, 0 not to.No0

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.

Data returned

An array of fields, corresponding to the rows of the people table in the database.

Example: With required parameters

http://enswitch.example.com/api/json/people/search/list/?auth_username=user;auth_password=password

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":[ { "id":1, "username":"user1@example.com", ... }, { "id":2, "username":"user2@example.com", ... }, ] }

Change history

VersionChanges
3.13Function added.