Source: https://atomicwork-preview.docs-staging.pageloop.ai/api-reference/users/getapi-v-1-users-list

# Get paginated users list

GET `https://{tenant}.atomicwork.com/api/v1/users/list`

## Authorization

#### X-Api-Key (header, string, required)

## Headers

#### X-Workspace-Id (header, string)

## Query Parameters

#### search\_key (query, string)

#### page (query, integer, required)

#### per\_page (query, integer)

#### sort\_order (query, enum (string))

#### is\_deleted (query, boolean)

#### has\_slack (query, boolean)

#### role (query, string)

#### role\_id (query, integer)

#### user\_status (query, enum (string))

#### invitation\_status (query, enum (string))

#### types (query, array of enum (string))

Optional comma-separated list of user types to filter by

#### expand (query, array of enum (string))

#### excluded\_user\_ids (query, array of integer)

#### notification\_enabled (query, boolean)

Filter users by notification enabled status

#### employee\_id (query, string)

Filter users by employee ID (exact match)

## Response

#### 200

Successful response

#### Request

```bash cURL
curl -X GET 'https://{tenant}.atomicwork.com/api/v1/users/list' \
  -H 'X-Api-Key: <api-key>'
```

```javascript JavaScript
const res = await fetch('https://{tenant}.atomicwork.com/api/v1/users/list', {
  method: 'GET',
  headers: {
    'X-Api-Key': '<api-key>',
  },
});
const data = await res.json();
```

```python Python
import requests

res = requests.get(
    'https://{tenant}.atomicwork.com/api/v1/users/list',
    headers={'X-Api-Key': '<api-key>'}
)
data = res.json()
```