/{app_slug}/v1/tenants/{tenant_id}/membersAuthList members of a tenant. Cursor-paginated by joined_at desc. Filter by `?search=` and/or `?role=`. PAK must hold auth.tenant.read.
Path parameters
app_slug*stringSlug of the app.
tenant_id*stringId of the tenant.
Query parameters
limitintegerPage size. Defaults to 20, clamped to 100. Values that do not parse as a positive integer (negatives, fractions, text) fall back to the default.
cursorstringOpaque `next_cursor` from the previous page. Keyed to the `joined_at DESC, account_id DESC` ordering.
searchstringCase-insensitive substring match on the member's username, account display name, or any contact value (email / phone). Composes with `role` and with the cursor.
rolestringExact role name (case-insensitive) from the app's `role` table.
Response · 200 List page of members.
data*arrayThe tenant membership items on this page.
pagination*objectnext_cursor*stringOpaque cursor for the next page. `null` when no more pages are available.
Example: "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ"
has_more*booleanTrue iff another page exists; if true, pass `next_cursor` on the next request.
Example: false
Example
Request
GET https://api.auth.productcraft.co/{app_slug}/v1/tenants/{tenant_id}/members
Authorization: Bearer YOUR_TOKENimport { Auth } from "@productcraft/auth";
// Admin routes read PRODUCTCRAFT_API_KEY; consumer routes need no key
const auth = new Auth();
for await (const member of auth.consumer("my-app").tenants.members.list("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f")) {
console.log(member);
}
const page = await auth.consumer("my-app").tenants.members.list("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f", {}, { timeout: 5_000 });auth.consumer(…).tenants.members.list(tenantId, params?, options?): PagePromise<Auth.ConsumerTenantMembership>
Response
{
"data": [
{
"id": "string",
"tenant_id": "string",
"account_id": "string",
"role_id": "string",
"role_name": "string",
"joined_at": "2026-01-01T00:00:00.000Z",
"invited_by": "string"
}
],
"pagination": {
"next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ",
"has_more": false
}
}