Skip to main content
GET
List app users

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app whose users you want to list.

Query Parameters

q
string

Filter as a JSON object of field names and values, for example {"status": "paid"} for an exact match, or using an operator such as $gt for a comparison. See Filtering, sorting, and paging for a full list of operators.

limit
integer

Maximum number of users to return, from 1 to 10000. Leave it out to get every matching user in one response.

skip
integer
default:0

Number of users to skip before the ones you get back, 0 or more. Defaults to 0. Use it with limit to page through a long list.

sort
string

Single field to sort by, prefixed with - for descending. For example, -created_date returns newest first. Sorting by more than one field isn't supported.

fields
string

Comma-separated list of fields to return, which reduces the response size on a wide entity. Reach a field inside an object with dots, as in customer.email. Each record still carries its id whether you ask for it or not.

Response

The app's users.

id
string | null

ID of the user.

Example:

"6874b0c2e1a94d0031bb77de"

email
string | null

Email the user signs in with.

Example:

"jane@acme.com"

full_name
string | null

The user's name, or null if they haven't given one.

Example:

"Jane Cooper"

role
string | null

The user's role in the app. user and admin are built in, and an app can define its own.

Example:

"user"

collaborator_role
string | null

editor when the user can also edit the app in Base44, otherwise null.

Allowed value: "editor"
Example:

"editor"

created_date
string | null

When the user joined the app, as a UTC timestamp in ISO 8601 format.

Example:

"2026-06-01T09:23:41.481000Z"

updated_date
string | null

When the user's record last changed, as a UTC timestamp in ISO 8601 format.

Example:

"2026-06-04T14:07:02.115000Z"