# List users

URL: /en/docs/api/v1/users/get
Last Updated: 2026-07-30T21:15:44.973Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/users

**List users**

Retrieve all users belonging to the current tenant, filtered to exclude account users and API users.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Query parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `search` | string | No | Search users by name or email |
| `role` | enum: admin \| account_manager \| content_manager \| viewer | No | Filter by user role |
| `status` | enum: active \| invited \| suspended \| archived | No | Filter by user status |

**Responses:**

- `200` - List of users for the current tenant
  - `users` (array of User (object))
    - `id` (string (uuid)): Unique user identifier
    - `first_name` (string): User's first name
    - `last_name` (string): User's last name
    - `email` (string (email)): User's email address
    - `role` (object): User's role information
      - `name` (string): Display name of the user's role
    - `status` (enum: active | invited | suspended | archived): User account status
    - `title` (string): User's job title
    - `theme` (enum: light | dark | system): User's UI theme preference
    - `language` (string): User's language preference

  Example (Successful response):
  
  ```json
  {
  "users": [
    {
      "id": "user-123",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com",
      "role": {
        "name": "Administrator"
      },
      "status": "active"
    }
  ]
}
  ```
- `401` - Unauthorized - invalid or missing authentication token
- `403` - Forbidden - Admin role required
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/users" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```