List Members
List everyone who belongs to your active account — their user id, email, username, the role they hold, when they joined, and whether they are the account owner.
Every account has exactly one owner. The owner is returned with is_owner: true and no role_id (the owner implicitly has full access). All other members carry the role they were assigned. Use this to render a team-management table or to look up a member's id before changing their role or removing them.
Permission required
Calling this endpoint requires the members:read permission on the active account.
Response (200 OK)
An object with a members array. Each entry contains:
user_id int64
The member's user id. Pass this as the
{userID} path parameter when changing a role or removing the member.email string
The member's email address.
username string
The member's username.
is_owner boolean
true for the single account owner. The owner cannot be removed and has no assignable role — ownership changes only via /account/transfer-owner.role_id int64
The id of the member's role. Omitted for the owner.
role_name string
Human-readable name of the member's role (e.g.
"Developer"). Omitted for the owner.status string
Membership status (e.g.
"active").joined_at datetime
RFC 3339 timestamp of when the member joined the account.
Errors
401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, or the caller lacks
members:read.500
Failed to load members (database error).
Request
curl "https://api.ngris.com/v1/account/members" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
members = client.account.list_members()
for m in members:
print(m["email"], m["role_name"] if not m["is_owner"] else "Owner")
Response — 200 OK
{
"members": [
{
"user_id": 1024,
"email": "alice@example.com",
"username": "alice",
"is_owner": true,
"status": "active",
"joined_at": "2026-01-12T09:00:00Z"
},
{
"user_id": 2048,
"email": "bob@example.com",
"username": "bob",
"is_owner": false,
"role_id": 7,
"role_name": "Developer",
"status": "active",
"joined_at": "2026-03-04T14:30:00Z"
}
]
}