List Users

GET {{baseUrl}}/api/v2/users?role=<string>&role[]=<string>&permission_set=<integer>&external_id=<string>

Pagination

  • Cursor pagination (recommended)
  • Offset pagination

See Pagination.

Returns a maximum of 100 records per page.

Allowed For

  • Admins, Agents and Light Agents

Request Params

KeyDatatypeRequiredDescription
rolestringFilters the results by role. Possible values are "end-user", "agent", or "admin"
role[]stringFilters the results by more than one role using the format role[]={role}&amp;role[]={role}
permission_setstringFor custom roles which is available on the Enterprise plan and above. You can only filter by one role ID per request
external_idstringList users by external id. External id has to be unique for each user under the same account.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;users&quot;:[{&quot;id&quot;:223443,&quot;name&quot;:&quot;Johnny Agent&quot;},{&quot;id&quot;:8678530,&quot;name&quot;:&quot;James A. Rosen&quot;}]}