List organization memberships
list_organization_membershipsList an organization's members with their roles, permissions, and public user identity in an application instance. Supports Backend API membership filters, pagination, and a total count. Membership and organization private metadata are never returned.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"application_id": "<application_id>",
"instance": "<instance>",
"organization_id": "<organization_id>"
},
"name": "list_organization_memberships"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Filter by role keys, such as org:admin or org:member. | |
| limit | No | Maximum memberships to return (default 10). | |
| query | No | Partial match across user identity fields. | |
| offset | No | Memberships to skip before returning results. | |
| user_id | No | Filter by literal user IDs. Prefixes are not interpreted as include/exclude operators. | |
| instance | Yes | Instance to target: "development", "production", or a full instance ID (ins_…). | |
| order_by | No | Sort by created_at, email_address, phone_number, first_name, last_name, username, or role. Prefix with - for descending. | |
| username | No | Filter by exact usernames. | |
| name_query | No | Case-insensitive partial name match. | |
| web3_wallet | No | Filter by exact web3 wallet addresses. | |
| phone_number | No | Filter by exact phone numbers. | |
| email_address | No | Filter by exact email addresses. | |
| application_id | Yes | Clerk application ID (app_…). | |
| username_query | No | Case-insensitive partial username match. | |
| organization_id | Yes | Organization whose members to list. | |
| created_at_after | No | User creation lower bound as a Unix timestamp in milliseconds. | |
| created_at_before | No | User creation cutoff as a Unix timestamp in milliseconds. | |
| phone_number_query | No | Partial phone number match. | |
| email_address_query | No | Case-insensitive partial email address match. | |
| last_active_at_after | No | User activity lower bound as a Unix timestamp in milliseconds. | |
| last_active_at_before | No | User activity cutoff as a Unix timestamp in milliseconds. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| total_count | Yes |