/{app_slug}/v1/admin/usersAuthList end-users in this app
Cursor-paginated. Supports the same `status` and `search` filters as the auth-admin equivalent. Use the cursor in subsequent calls — Auth does not expose offset pagination.
Path parameters
app_slug*stringSlug of the app.
Query parameters
limitintegerPage size. Defaults to 20, clamped to 100.
cursorstringOpaque `next_cursor` from the previous page.
statusenum (3)Only users with this status.
searchstringCase-insensitive substring of the username or of any contact (email or phone).
Response · 200
data*arrayThe end user 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/admin/users
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 user of auth.consumer("my-app").users.list()) {
console.log(user);
}
const page = await auth.consumer("my-app").users.list({}, { timeout: 5_000 });auth.consumer(…).users.list(params?, options?): PagePromise<Auth.ConsumerAdminEndUser>
Response
{
"data": [
{
"id": "string",
"username": "string",
"display_name": "string",
"status": "string",
"role": "string",
"joined_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z",
"email": "string",
"email_verified_at": "2026-01-01T00:00:00.000Z",
"active_session_count": 0,
"last_used_at": "2026-01-01T00:00:00.000Z"
}
],
"pagination": {
"next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ",
"has_more": false
}
}