> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browsary.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Users

> Read-only endpoints for listing or inspecting user profiles.

These endpoints are primarily for administrative tooling or auto-complete features. They never expose passwords or tokens.

## GET `/api/users`

* **Auth** – optional.
* **Query params** – `limit` and `offset` for pagination.
* **Response** – each entry contains:
  * Unauthenticated callers: `{ id, firstName, lastName }`.
  * Authenticated callers: the fields above plus `{ email, created }`.

Example:

```json theme={null}
[
  {
    "id": "usr_123",
    "firstName": "Ada",
    "lastName": "Lovelace",
    "email": "ada@example.com",
    "created": "2024-04-20T10:25:38.000Z"
  }
]
```

## GET `/api/users/{id}`

* **Auth** – optional.
* **Response** – same shape as the list endpoint but for a single user. When the user does not exist the API responds with HTTP 400 and `{ "status": "error", "message": "User not found with id: ..." }`.