List team members
GET
/v1/users
role (administrator/contributor), an is_primary flag (the owner), and a status (active/invited/paused). created_at is the member's account-creation time — null for invited seats (no account yet), and rarely for a member whose login email no longer matches their seat. Most orgs have a single member (the owner). Always paginated with the universal cursor envelope (default per_page 25, max 100); the cursor is opaque — clients MUST NOT parse it. Members are sorted by email; the owner is identified by is_primary, not list position. role reflects the seat assignment the dashboard's Team tab displays — display truth, not an enforced-capability guarantee (see the v1 contract).Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.mailfloss.com/v1/users?per_page=&cursor=' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success
{
"data": [
{
"id": "usr_amFuZUBhY21lLmNvbQ",
"email": "jane@acme.com",
"name": "Jane Smith",
"role": "administrator",
"is_primary": true,
"status": "active",
"created_at": "2026-01-15T08:45:00Z"
},
{
"id": "usr_am9obkBhY21lLmNvbQ",
"email": "john@acme.com",
"name": "John Analyst",
"role": "contributor",
"is_primary": false,
"status": "invited",
"created_at": null
}
],
"pagination": {
"next_cursor": null,
"has_more": false
}
}Modified at 2026-10-20 13:54:45