GET /api/users
List all users

GET /api/auth_source_ldaps/:auth_source_ldap_id/users
List all users for LDAP authentication source

GET /api/auth_source_externals/:auth_source_external_id/users
List all users for external authentication source

GET /api/usergroups/:usergroup_id/users
List all users for user group

GET /api/roles/:role_id/users
List all users for role

GET /api/locations/:location_id/users
List all users for location

GET /api/organizations/:organization_id/users
List all users for organization

Examples

GET /api/users
200
{
  "total": 7,
  "subtotal": 7,
  "page": 1,
  "per_page": 20,
  "search": null,
  "sort": {
    "by": null,
    "order": null
  },
  "results": [
    {
      "firstname": "Admin",
      "lastname": "User",
      "mail": "admin@someware.com",
      "admin": true,
      "auth_source_id": 200482051,
      "auth_source_name": "Internal",
      "timezone": null,
      "locale": null,
      "last_login_on": "2009-10-12 21:50:04 UTC",
      "created_at": "2018-07-24 13:02:47 UTC",
      "updated_at": "2018-07-24 13:02:47 UTC",
      "id": 135138680,
      "login": "secret_admin",
      "description": null,
      "ssh_keys": [],
      "default_location": null,
      "locations": [],
      "default_organization": null,
      "organizations": [],
      "effective_admin": true
    },
    {
      "firstname": "apiadmin",
      "lastname": "User",
      "mail": "apiadmin@someware.com",
      "admin": true,
      "auth_source_id": 200482051,
      "auth_source_name": "Internal",
      "timezone": null,
      "locale": null,
      "last_login_on": "2009-10-12 21:50:04 UTC",
      "created_at": "2018-07-24 13:02:47 UTC",
      "updated_at": "2018-07-24 13:02:47 UTC",
      "id": 886836129,
      "login": "apiadmin",
      "description": null,
      "ssh_keys": [],
      "default_location": null,
      "locations": [],
      "default_organization": null,
      "organizations": [],
      "effective_admin": true
    },
    {
      "firstname": "One",
      "lastname": "User",
      "mail": "userone@someware.com",
      "admin": false,
      "auth_source_id": 980190962,
      "auth_source_name": "ldap-server",
      "timezone": null,
      "locale": null,
      "last_login_on": "2009-10-12 21:50:04 UTC",
      "created_at": "2018-07-24 13:02:47 UTC",
      "updated_at": "2018-07-24 13:02:47 UTC",
      "id": 980190962,
      "login": "one",
      "description": null,
      "ssh_keys": [],
      "default_location": null,
      "locations": [
        {
          "id": 255093256,
          "name": "Location 1"
        }
      ],
      "default_organization": null,
      "organizations": [
        {
          "id": 447626438,
          "name": "Organization 1"
        }
      ],
      "effective_admin": false
    },
    {
      "firstname": "Restricted",
      "lastname": "User",
      "mail": "userrestricted@someware.com",
      "admin": false,
      "auth_source_id": 980190962,
      "auth_source_name": "ldap-server",
      "timezone": null,
      "locale": null,
      "last_login_on": "2009-10-12 21:50:04 UTC",
      "created_at": "2018-07-24 13:02:47 UTC",
      "updated_at": "2018-07-24 13:02:47 UTC",
      "id": 130842698,
      "login": "restricted",
      "description": null,
      "ssh_keys": [],
      "default_location": null,
      "locations": [],
      "default_organization": null,
      "organizations": [],
      "effective_admin": false
    },
    {
      "firstname": "Scoped",
      "lastname": "User",
      "mail": "userscoped@someware.com",
      "admin": false,
      "auth_source_id": 980190962,
      "auth_source_name": "ldap-server",
      "timezone": null,
      "locale": null,
      "last_login_on": "2009-10-12 21:50:05 UTC",
      "created_at": "2018-07-24 13:02:47 UTC",
      "updated_at": "2018-07-24 13:02:47 UTC",
      "id": 117925625,
      "login": "scoped",
      "description": null,
      "ssh_keys": [],
      "default_location": null,
      "locations": [
        {
          "id": 255093256,
          "name": "Location 1"
        }
      ],
      "default_organization": null,
      "organizations": [
        {
          "id": 447626438,
          "name": "Organization 1"
        }
      ],
      "effective_admin": false
    },
    {
      "firstname": "test",
      "lastname": "User",
      "mail": "testuser@someware.com",
      "admin": false,
      "auth_source_id": 200482051,
      "auth_source_name": "Internal",
      "timezone": null,
      "locale": null,
      "last_login_on": "2009-10-12 21:50:04 UTC",
      "created_at": "2018-07-24 13:02:47 UTC",
      "updated_at": "2018-07-24 13:02:47 UTC",
      "id": 200482051,
      "login": "test",
      "description": null,
      "ssh_keys": [],
      "default_location": null,
      "locations": [],
      "default_organization": null,
      "organizations": [],
      "effective_admin": false
    },
    {
      "firstname": "Two",
      "lastname": "User",
      "mail": "usertwo@someware.com",
      "admin": false,
      "auth_source_id": 980190962,
      "auth_source_name": "ldap-server",
      "timezone": null,
      "locale": null,
      "last_login_on": "2009-10-12 21:50:04 UTC",
      "created_at": "2018-07-24 13:02:47 UTC",
      "updated_at": "2018-07-24 13:02:47 UTC",
      "id": 298486374,
      "login": "two",
      "description": null,
      "ssh_keys": [],
      "default_location": null,
      "locations": [],
      "default_organization": null,
      "organizations": [],
      "effective_admin": false
    }
  ]
}

Params

Param name Description
auth_source_ldap_id
optional

ID of LDAP authentication source

Validations:

  • Must be a String
usergroup_id
optional

ID of user group

Validations:

  • Must be a String
role_id
optional

ID of role

Validations:

  • Must be a String
location_id
optional

Scope by locations

Validations:

  • Must be a Integer
organization_id
optional

Scope by organizations

Validations:

  • Must be a Integer
search
optional

filter results

Validations:

  • Must be a String
order
optional

Sort field and order, eg. ‘id DESC’

Validations:

  • Must be a String
page
optional

paginate results

Validations:

  • Must be a String
per_page
optional

number of entries per request

Validations:

  • Must be a String

Search fields

Field name Type Possible values
admin true, false
description text
firstname string
last_login_on datetime
lastname string
location string
location_id integer
login string
mail string
organization string
organization_id integer
role string
role_id integer
usergroup string