Auth API reference

Auth API · Consumer-Tenants

get/{app_slug}/v1/tenants/{tenant_id}/membersAuth

List 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*string

Slug of the app.

tenant_id*string

Id of the tenant.

Query parameters

limitinteger

Page size. Defaults to 20, clamped to 100. Values that do not parse as a positive integer (negatives, fractions, text) fall back to the default.

cursorstring

Opaque `next_cursor` from the previous page. Keyed to the `joined_at DESC, account_id DESC` ordering.

searchstring

Case-insensitive substring match on the member's username, account display name, or any contact value (email / phone). Composes with `role` and with the cursor.

rolestring

Exact role name (case-insensitive) from the app's `role` table.

Response · 200 List page of members.

data*array

The tenant membership items on this page.

pagination*object
next_cursor*string

Opaque cursor for the next page. `null` when no more pages are available.

Example: "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ"

has_more*boolean

True 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_TOKEN

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
  }
}