# List organization users

div
strong
🔨 In Development
 — This section is still being developed and may change.


Get paginated list of organization users with search, filtering, and sorting capabilities.

#### Path Parameters

**`org_id`** string required

Organization ID (e.g., "ORG_B66136CBB1304C98").

#### Request Body

**`page`** integer optional · Defaults to `1`

Page number for pagination.

**`pageSize`** integer optional · Defaults to `50`

Number of users per page.

**`searchTerm`** string optional

Search term to filter users by name or email.

**`sortBy`** string optional · Defaults to `"createdAt"`

Field to sort by.

**`sortOrder`** string optional · Defaults to `"desc"`

Sort order: `"asc"` or `"desc"`.

**`filters`** object optional

Filter criteria object.

## Returns

A [ListOrganizationUsersResponse](#listorganizationusersresponse) object.

List All Users

```bash
curl -X POST https://api.freddy.aitronos.com/v1/organization/ORG_B66136CBB1304C98/users \
-H "Authorization: Bearer $FREDDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "page": 1,
  "pageSize": 50
}'
```


```python
import requests

response = requests.post(
  f"https://api.freddy.aitronos.com/v1/organization/{org_id}/users",
  headers={"Authorization": f"Bearer {api_key}"},
  json={
      "page": 1,
      "pageSize": 50
  }
)

users_data = response.json()
print(f"Found {users_data['totalCount']} users")
```


```javascript
const response = await fetch(`https://api.freddy.aitronos.com/v1/organization/${orgId}/users`, {
method: 'POST',
headers: {
  'Authorization': `Bearer ${apiKey}`,
  'Content-Type': 'application/json'
},
body: JSON.stringify({
  page: 1,
  pageSize: 50
})
});

const usersData = await response.json();
console.log(`Found ${usersData.totalCount} users`);
```

Search Users

```bash
curl -X POST https://api.freddy.aitronos.com/v1/organization/ORG_B66136CBB1304C98/users \
-H "Authorization: Bearer $FREDDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "searchTerm": "john",
  "page": 1,
  "pageSize": 20
}'
```


```python
import requests

response = requests.post(
  f"https://api.freddy.aitronos.com/v1/organization/{org_id}/users",
  headers={"Authorization": f"Bearer {api_key}"},
  json={
      "searchTerm": "john",
      "page": 1,
      "pageSize": 20
  }
)

users_data = response.json()
print(f"Found {len(users_data['users'])} users matching 'john'")
```


```javascript
const response = await fetch(`https://api.freddy.aitronos.com/v1/organization/${orgId}/users`, {
method: 'POST',
headers: {
  'Authorization': `Bearer ${apiKey}`,
  'Content-Type': 'application/json'
},
body: JSON.stringify({
  searchTerm: 'john',
  page: 1,
  pageSize: 20
})
});

const usersData = await response.json();
console.log(`Found ${usersData.users.length} users matching 'john'`);
```

Filter by Status

```bash
curl -X POST https://api.freddy.aitronos.com/v1/organization/ORG_B66136CBB1304C98/users \
-H "Authorization: Bearer $FREDDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "filters": {
    "status": "active"
  },
  "page": 1,
  "pageSize": 25
}'
```


```python
import requests

response = requests.post(
  f"https://api.freddy.aitronos.com/v1/organization/{org_id}/users",
  headers={"Authorization": f"Bearer {api_key}"},
  json={
      "filters": {
          "status": "active"
      },
      "page": 1,
      "pageSize": 25
  }
)

users_data = response.json()
active_users = [u for u in users_data['users'] if u['status'] == 'active']
print(f"Found {len(active_users)} active users")
```


```javascript
const response = await fetch(`https://api.freddy.aitronos.com/v1/organization/${orgId}/users`, {
method: 'POST',
headers: {
  'Authorization': `Bearer ${apiKey}`,
  'Content-Type': 'application/json'
},
body: JSON.stringify({
  filters: {
    status: 'active'
  },
  page: 1,
  pageSize: 25
})
});

const usersData = await response.json();
const activeUsers = usersData.users.filter(u => u.status === 'active');
console.log(`Found ${activeUsers.length} active users`);
```

## Response


```json
{
  "users": [
    {
      "id": "uid_abc123def456",
      "email": "john.doe@company.com",
      "fullName": "John Doe",
      "userName": "johndoe",
      "status": "active",
      "role": "member",
      "department": "Engineering",
      "lastLoginAt": "2025-01-15T14:30:00Z",
      "createdAt": "2025-01-10T09:00:00Z",
      "invitedAt": "2025-01-10T08:45:00Z",
      "isVerified": true
    },
    {
      "id": "uid_def456ghi789",
      "email": "jane.smith@company.com",
      "fullName": "Jane Smith",
      "userName": "janesmith",
      "status": "active",
      "role": "admin",
      "department": "Product",
      "lastLoginAt": "2025-01-14T16:20:00Z",
      "createdAt": "2025-01-09T11:15:00Z",
      "invitedAt": "2025-01-09T10:30:00Z",
      "isVerified": true
    }
  ],
  "totalCount": 2,
  "page": 1,
  "pageSize": 50,
  "totalPages": 1,
  "hasNext": false,
  "hasPrev": false
}
```