v29

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-13511526891.2 KB
Users

Count Users

Returns an approximate count of users. If the count exceeds 100,000, it is updated every 24 hours.

The response includes a refreshed_at property in a count object that contains a timestamp indicating when the count was last updated.

Note: When the count exceeds 100,000, the refreshed_at property may occasionally be null. This indicates that the count is being updated in the background. The count object's value property is limited to 100,000 until the update is complete.

Allowed For

  • Admins, Agents and Light Agents
get/api/v2/users/count

Query parameters

role'end-user' | 'agent' | 'admin'

Filters the results by role. Possible values are "end-user", "agent", or "admin"

role[]string

Filters the results by more than one role using the format role[]={role}&role[]={role}

permission_setinteger

For custom roles which is available on the Enterprise plan and above. You can only filter by one role ID per request

Response

Success response