Auth API reference

Auth API · Consumer-Admin

get/{app_slug}/v1/admin/usersAuth

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

Slug of the app.

Query parameters

limitinteger

Page size. Defaults to 20, clamped to 100.

cursorstring

Opaque `next_cursor` from the previous page.

statusenum (3)

Only users with this status.

searchstring

Case-insensitive substring of the username or of any contact (email or phone).

Response · 200

data*array

The end user 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/admin/users
Authorization: Bearer YOUR_TOKEN

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