Skip to main content
GET
/
{workspace_id}
/
users
List users
curl --request GET \
  --url https://app.base44.com/api/v1/monitoring/{workspace_id}/users \
  --header 'api_key: <api-key>'
{
  "users": [
    {
      "user_id": "usr_abc123",
      "email": "jane.doe@company.com",
      "seat_type": "<string>",
      "created_at": "2024-03-15T10:30:00Z",
      "is_active": true,
      "role": "member",
      "total_apps": 12,
      "active_last_30d": true,
      "total_message_credits": 1250,
      "total_integration_credits": 340,
      "total_credits": 1590,
      "member_allocation": {
        "credit_limit": 1000,
        "credit_limit_source": "org_default",
        "credit_limit_used": 420,
        "credit_limit_remaining": 580,
        "credit_limit_exceeded": false
      }
    }
  ],
  "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.

​
tier
string | null

Filter by workspace tier, such as "builder", "pro", or "enterprise". Use the base tier name, which matches its numbered sub-tiers. Preferred over the deprecated seat_type.

​
seat_type
string | null
deprecated

Deprecated: Filter by subscription tier. Use tier instead. tier is the preferred alias for the same filter.

​
over_member_limit
boolean
default:false

Return only members whose consumption has exceeded their per-member credit limit in the current credit reset period. Has no effect when the workspace tier does not enforce per-member limits.

​
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

Successful Response

Paginated list of users.

​
users
AnalyticsUserRecord · object[]
required

List of users.

​
pagination
PaginationMetadata · object
required

Pagination metadata.