Get users

GET
/api/v1/users

Retrieves a list of users ordered by their first name.

Authorization

auth ApiKey
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

In: header

X-API-KEY<token>

Internal API key for admin endpoints. Example: "X-API-KEY: {key}"

In: header

Query Parameters

sort_by?string

Sort by field name (optional). Supported fields: "name", "email", "status", "type", "createdDate"

firstName?string

User first name used for filtering. Optional filter operators can be applied to refine the search:

  • equal (default)
  • contains
  • startswith
  • endswith
lastName?string

User last name used for filtering. Optional filter operators can be applied to refine the search:

  • equal (default)
  • contains
  • startswith
  • endswith
group_id?string

Filter by group ID (optional). Returns users that belong to the specified group.

Formatuuid
status?string

Filter by user status (optional). Available values: "Active", "Disabled", "Pending"

AllowedOrganizationIds?array<>
page?integer

Page number (1-based). Default is 1.

Formatint32
Range1 <= value <= 2147483647
page_size?integer

Number of items per page. Default is 10. Maximum is 50.

Formatint32
Range1 <= value <= 50
sort_direction?string

Sort direction: "asc" or "desc". Default is "asc" (optional)

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/users"
{  "isSuccess": true,  "error": {},  "errorDetails": "string",  "message": "string",  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "email": "string",      "type": "string",      "status": "string",      "tenantAdminRole": "string",      "license": "string",      "isTenantOwner": true,      "organizationRoles": [        {          "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",          "organization": "string",          "roleName": "string"        }      ],      "groups": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string"        }      ]    }  ],  "resultInfo": {    "page": 0,    "perPage": 0,    "totalCount": 0,    "totalPages": 0,    "hasPreviousPage": true,    "hasNextPage": true  }}