# List Users

Retrieve a paginated list of users with optional filtering.

## Query Parameters

**`skip`** integer optional

Number of records to skip (default: 0).

**`limit`** integer optional

Maximum number of records to return (default: 100).

**`active_only`** boolean optional

If true, return only active users (default: false).

## Returns

Array of User objects.

Request

```bash
curl -X GET \
  "https://api.aitronos.com/v1/user?skip=0&limit=100&active_only=true"
```


```python
import requests

response = requests.get(
    "https://api.aitronos.com/v1/user",
    params={"skip": 0, "limit": 100, "active_only": True}
)
```


```javascript
const response = await fetch('https://api.aitronos.com/v1/user?skip=0&limit=100&active_only=true');
```

**Response:**

200 OK

```json
[
  {
    "id": "usr_abc123",
    "email": "user1@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "is_active": true,
    "last_verified": "2025-11-19T10:00:00Z",
    "global_role_id": "role_admin",
    "created_at": "2025-01-15T08:00:00Z",
    "updated_at": "2025-11-19T10:00:00Z"
  },
  {
    "id": "usr_def456",
    "email": "user2@example.com",
    "first_name": "Jane",
    "last_name": "Smith",
    "is_active": true,
    "last_verified": "2025-11-18T15:30:00Z",
    "global_role_id": "role_member",
    "created_at": "2025-02-20T09:00:00Z",
    "updated_at": "2025-11-18T15:30:00Z"
  }
]
```