Skip to content
/
List members
Last updated

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

POST/v1/organizations/{organization_id}/users

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"
  }'

Response:

{
  "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
}
Previous page
Next page