---
title: "List users of your company"
method: GET
path: "/users"
tags: ["users"]
deprecated: true
---

# List users of your company

`GET /users`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/users`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `users_read`

> **Deprecated.**

## Query parameters

- `q` string
- `limit` integer
- `offset` integer
- `updatedAfter` string, date-time

## Response `200`

List of users in your company

- Users
  - `totalFound` integer
  - `limit` integer
  - `offset` integer
  - `content` UserListItem[]
    - `email` string, email
    - `firstName` string, name, required
    - `lastName` string, name, required
    - `role` 'EMPLOYEE' | 'RESTRICTED' | 'STANDARD' | 'EXTENDED' | 'ADMINISTRATOR', required
    - `externalData` string, nullable
    - `language` object, required
      - `code` 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'es-MX' | 'fi' | 'fr' | 'fr-CA' | 'hr' | 'hu' | 'id' | 'it' | 'ja' | 'lt' | 'nl' | 'no' | 'pl' | 'pt' | 'pt-BR' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh-CN' | 'zh-TW' | 'ka', required: Language assigned to user account. Language code, can be two-letter for the standard variant or with additional two letters after a hyphen to identify a specific locale
    - `id` string
    - `active` boolean
    - `updatedOn` string, date-time

## Other responses

- `403`: with code * **PERMISSION_DENIED** Not permitted to manage users

---

[API](https://skmtc.dev/smartrecruiters/apis/users-api-deprecated.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/users-api-deprecated/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/users-api-deprecated/revisions/ce7ffb4e9310?raw)