List your organisation's members
Every person seated in your organisation, oldest first. Any role can read it with a session or API key, not a widget key. Keys are not listed.
GET
/
members
curl "$MITHUNAI_URL/mithunai/api/v1/members?limit=50" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/members",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"limit": 50},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/members?limit=50`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log((await response.json()).data)
{
"data": [
{
"account_id": "3b8f1d2e-6a4c-4f9b-8e1d-2c5a7b9e0f13",
"email": "alex@example.com",
"name": "Alex Mercer",
"role": "owner",
"status": "active"
},
{
"account_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "sarah.chen@example.com",
"name": "Sarah Chen",
"role": "editor",
"status": "active"
}
],
"limit": { "max": 100 }
}
{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }
Returns the people in your organisation, oldest membership first. Every role can read this list, with a console session or an API key. A widget key cannot, so a visitor to your website cannot enumerate your staff. API keys and widget embeds are not people and are not listed.
The list is a single page of at most 100 members; there is no cursor.
integer
default:"100"
How many members to return, from 1 to 100. A value outside that range returns
400; it is not
clamped.Response
object[]
required
The members, oldest first.
Show properties
Show properties
string
required
The member’s account ID (UUID).
string
required
The account’s email address.
string
required
The account’s display name.
string
required
owner, admin, editor, normal or dataset_operator.string
required
active, pending (not yet accepted) or suspended (access withdrawn). Only active grants
access.curl "$MITHUNAI_URL/mithunai/api/v1/members?limit=50" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/members",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"limit": 50},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/members?limit=50`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log((await response.json()).data)
{
"data": [
{
"account_id": "3b8f1d2e-6a4c-4f9b-8e1d-2c5a7b9e0f13",
"email": "alex@example.com",
"name": "Alex Mercer",
"role": "owner",
"status": "active"
},
{
"account_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "sarah.chen@example.com",
"name": "Sarah Chen",
"role": "editor",
"status": "active"
}
],
"limit": { "max": 100 }
}
{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }
Last modified on November 7, 2026
curl "$MITHUNAI_URL/mithunai/api/v1/members?limit=50" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/members",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"limit": 50},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/members?limit=50`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log((await response.json()).data)
{
"data": [
{
"account_id": "3b8f1d2e-6a4c-4f9b-8e1d-2c5a7b9e0f13",
"email": "alex@example.com",
"name": "Alex Mercer",
"role": "owner",
"status": "active"
},
{
"account_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "sarah.chen@example.com",
"name": "Sarah Chen",
"role": "editor",
"status": "active"
}
],
"limit": { "max": 100 }
}
{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }