# GET /v1/users - List users in current organization

Source: <https://everruns.com/docs/api/operations/list_users/>

GET

/v1/users

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/users';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/users
```

* Production APIapp.everruns.com/api/v1/users

Lists users that belong to the current organization with optional search filtering. TM-TENANT-008: Enforces org isolation to prevent cross-tenant user enumeration.

## Parameters

### Query Parameters

**search**

string

Search by name or email

## Responses

### 200

List of users in organization

Media typeapplication/json

Response wrapper for list endpoints. All list endpoints return responses wrapped in a `data` field.

object

**data**

required

Array of items returned by the list operation.

Array\<object>

User response for listing

object

**auth\_provider**

string | null

**avatar\_url**

string | null

**created\_at**

required

Timestamp when this resource was created (RFC 3339).

string format: date-time

**email**

required

string

**id**

required

Prefixed public identifier. See [ID Schema](https://everruns.com/docs/advanced/id-schema/).

string

**name**

required

Human-readable name. Safe to render in user-facing messages.

string

**roles**

required

Array\<string>

##### Examplegenerated

```json
{
  "data": [
    {
      "auth_provider": "example",
      "avatar_url": "example",
      "created_at": "2026-04-15T12:00:00Z",
      "email": "example",
      "id": "example",
      "name": "example",
      "roles": [
        "example"
      ]
    }
  ]
}
```

### 401

Unauthorized

### 500

Internal server error