List users

Returns a list of all users in the workspace with their profile and credit consumption data.

You can use the from and to parameters to specify the date range for credit consumption. If not specified, defaults to consumption during the current billing period.

You can use the returned user_id values to call:

• Get user: For user consumption data for a specific user over a custom date range.
• List user apps: To see a specific user’s app IDs.

Results are paginated. Check has_more in the response and use the returned cursor to fetch additional pages.

GET /{workspace_id}/users

List users

cURL

curl --request GET \
  --url https://app.base44.com/api/v1/monitoring/{workspace_id}/users \
  --header 'api_key: <api-key>'

200

{
  "users": [
    {
      "user_id": "usr_abc123",
      "email": "[e-mail]",
      "seat_type": "pro",
      "created_at": "2024-03-15T10:30:00Z",
      "is_active": true,
      "total_apps": 12,
      "active_last_30d": true,
      "total_message_credits": 1250,
      "total_integration_credits": 340,
      "total_credits": 1590
    }
  ],
  "pagination": {
    "total": 156,
    "limit": 50,
    "has_more": true,
    "next_cursor": "eyJsYXN0X2lkIjoiMTIzIn0="
  }
}

Authorizations

api_key · string · header · required

API key for authentication. See the Authentication page for your API for details on how to get your key.

Path Parameters

workspace_id · string · required

Query Parameters

limit · integer · default: 50

Items per page. Max 50.

Required range: 1 <= x <= 50

cursor · string | null

Pagination cursor from previous response.

active_only · boolean · default: false

Filter to users who consumed message credits in the last 30 days.

seat_type · string | null

Filter by subscription tier, such as "starter", "builder", or "pro". If not provided, returns all users.

from · string | null

Start date in YYYY-MM-DD format. Required if to is provided. Defaults to billing period start.

to · string | null

End date in YYYY-MM-DD format. Required if from is provided. Defaults to current date.

Response

200

application/json

Successful Response

Paginated list of users.

users · AnalyticsUserRecord · object[] · required

List of users.

Show child attributes

pagination · PaginationMetadata · object · required

Pagination metadata.

Show child attributes