# ListUsers

Fetches list of active users associated with a company. User must have a valid token with required permissions.

Endpoint: GET /users
Version: 1.0.0
Security: AuthorizationHeader

## Query parameters:

  - `from` (integer)
    Page number

  - `size` (integer)
    Records per page. By default no of records per page is 50.

  - `identifier` (string)
    Name or email Id of the user to search

  - `sort_by` (string)
    Sort by field name
    Enum: "name", "email", "added_date", "last_login", "status", "ip", "role"

  - `order` (string)
    Order by asc or desc
    Enum: "asc", "desc"

## Response 200 fields (application/json):

  - `error` (string)

  - `result` (object)

  - `result.data` (array)

  - `result.data._id` (string)

  - `result.data.added_date` (string)

  - `result.data.email` (string)

  - `result.data.ip` (string)
    omitempty because it's not in the second object

  - `result.data.is_amops` (boolean)

  - `result.data.last_login` (string)
    omitempty because it's not in the second object

  - `result.data.name` (string)

  - `result.data.period` (string)

  - `result.data.role` (string)

  - `result.data.status` (integer)

  - `result.data.locale` (string)

  - `result.total` (integer)

  - `success` (boolean)

## Response 400 fields (application/json):

  - `error` (string)

  - `result` (object)

  - `result.data` (array)

  - `result.data._id` (string)

  - `result.data.added_date` (string)

  - `result.data.email` (string)

  - `result.data.ip` (string)
    omitempty because it's not in the second object

  - `result.data.is_amops` (boolean)

  - `result.data.last_login` (string)
    omitempty because it's not in the second object

  - `result.data.name` (string)

  - `result.data.period` (string)

  - `result.data.role` (string)

  - `result.data.status` (integer)

  - `result.data.locale` (string)

  - `result.total` (integer)

  - `success` (boolean)

## Response 500 fields (application/json):

  - `error` (string)

  - `result` (object)

  - `result.data` (array)

  - `result.data._id` (string)

  - `result.data.added_date` (string)

  - `result.data.email` (string)

  - `result.data.ip` (string)
    omitempty because it's not in the second object

  - `result.data.is_amops` (boolean)

  - `result.data.last_login` (string)
    omitempty because it's not in the second object

  - `result.data.name` (string)

  - `result.data.period` (string)

  - `result.data.role` (string)

  - `result.data.status` (integer)

  - `result.data.locale` (string)

  - `result.total` (integer)

  - `success` (boolean)