Skip to content

List users

Request

Retrieves all users via REST API

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, display_name, status, manager_uuid, license_type, display_name, status, manager_uuid, license_type.

Available ransackable associations and their attributes:

  • direct_teams: direct_teams_uuid, direct_teams_display_name, direct_teams_parent_uuid, direct_teams_status, direct_teams_display_name, direct_teams_is_org, direct_teams_parent_uuid, direct_teams_depth
  • team_memberships: team_memberships_uuid, team_memberships_user_uuid
  • profile: profile_uuid, profile_first_name, profile_last_name, profile_job_title, profile_employee_type, profile_department_name, profile_division_name, profile_cost_center_name, profile_about, profile_custom_field_1, profile_custom_field_2, profile_custom_field_3, profile_custom_field_4, profile_custom_field_5
  • manager: manager_uuid, manager_display_name, manager_status, manager_manager_uuid, manager_license_type, manager_display_name, manager_status, manager_manager_uuid, manager_license_type
Query
pagenumber

Page number for pagination (default: 1)

Default:1
per_pagenumber

Number of records per page (default: 20, max: 100)

Default:20
limitnumber

Alias for per_page - number of records per page

Default:20
limit_maxnumber

Maximum number of records per page (overrides limit if not set)

Default:null
offsetnumber

Number of records to skip, for offset/limit clients such as BI connectors. An offset past the end of the collection returns an empty records array, which is the end-of-data signal. To follow data.pagy.next instead of stepping the offset yourself, send it as page while keeping the same offset.

countstring

Set to 'true' to include total count in pagy metadata (data.pagy.count). Use for count/total queries instead of paginating through all pages.

GET
/rest/v2/users
curl -i -X GET \
  'https://api.rhythms.ai/rest/v2/users?page=1&per_page=20&limit=20&limit_max=%7Blimit_max%7D&offset=0&count=string'

Responses

Success

Headers
any
Body*/*
dataobjectrequired
Response
{
  "data": {
    "type": null,
    "records": [
      {
        "uuid": "string",
        "display_name": "string",
        "account_id": null,
        "status": "active",
        "manager_uuid": null,
        "path": null,
        "creator_uuid": null,
        "license_type": "string",
        "display_name_source": "manual",
        "avatar_url": null,
        "external_employee_id": null
      }
    ],
    "pagy": null,
    "checks": null,
    "filters": null
  }
}