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

#### Path Parameters

**`organization_id`** string required

Organization ID

#### Request Body

**`skip`** integer optional · Defaults to `0`

Number of records to skip for pagination.

**`take`** integer optional · Defaults to `10`

Number of records to return. Min: 1, Max: 100.

**`search_term`** string optional

Search across full_name, email, and username.

**`role_id`** string optional

Filter by role ID.

**`status_id`** string optional

Filter by status ID.

**`sort_field`** string optional · Defaults to `created_at`

Field to sort by. Options: `full_name`, `email`, `role`, `status`, `created_at`, `last_modified_at`.

**`sort_direction`** string optional · Defaults to `desc`

Sort direction. Options: `asc`, `desc`.

**`include_deleted`** boolean optional · Defaults to `false`

Include soft-deleted members.

## Returns

Returns a paginated list of organization members with total count.

## Authorization

Requires Admin or Owner role.


```bash
curl -X POST https://api.aitronos.com/v1/organizations/org_abc123/users \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skip": 0,
    "take": 10,
    "search_term": "john",
    "sort_field": "created_at",
    "sort_direction": "desc"
  }'
```


```python
import requests
import os

api_key = os.environ["FREDDY_API_KEY"]
org_id = "org_abc123"

response = requests.post(
    f"https://api.aitronos.com/v1/organizations/{org_id}/users",
    headers={
        "X-API-Key": api_key,
        "Content-Type": "application/json"
    },
    json={
        "skip": 0,
        "take": 10,
        "search_term": "john",
        "sort_field": "created_at",
        "sort_direction": "desc"
    }
)

members = response.json()
```


```javascript
const response = await fetch('https://api.aitronos.com/v1/organizations/org_abc123/users', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    skip: 0,
    take: 10,
    search_term: 'john',
    sort_field: 'created_at',
    sort_direction: 'desc'
  })
});

const members = await response.json();
```

**Response:**

200 OK

```json
{
  "users": [
    {
      "id": "orguser_abc123",
      "user_id": "usr_xyz789",
      "organization_id": "org_def456",
      "full_name": "John Doe",
      "email": "john@example.com",
      "username": "johndoe",
      "role": {
        "id": "role_abc123",
        "name": "Admin"
      },
      "status": {
        "id": "status_xyz789",
        "name": "Active",
        "selectable_in_ui": true
      },
      "joined_at": "2025-01-15T10:30:00Z",
      "created_at": "2025-01-15T10:30:00Z",
      "last_modified_at": "2025-01-20T14:45:00Z"
    }
  ],
  "total_users_count": 45,
  "skip": 0,
  "take": 10
}
```

401 Unauthorized

```json
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required",
    "status": 401
  }
}
```

403 Forbidden

```json
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "Admin or Owner role required",
    "status": 403
  }
}
```