> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # List apps > Returns a paginated workspace-wide app inventory with owner, visibility, publish, activity, and credit-usage signals. This endpoint avoids client-side fan-out through every workspace user when building full app inventory views. ## OpenAPI ````yaml /developers/references/monitoring-api/monitoring-openapi.json get /{workspace_id}/apps openapi: 3.1.0 info: title: Base44 Workspace Monitoring API description: |2- Workspace monitoring and analytics API. Access usage analytics, user engagement metrics, and governance data for your workspace. **Features:** - Workspace-level analytics and KPIs - User activity tracking and credit consumption - app engagement metrics and security governance **Authentication:** Required for all endpoints (admin or owner role) Use the 🔒 **Authorize** button above to enter your API key. **Rate Limits:** - Analytics endpoints: 50 requests per minute per user - User list: 50 requests per minute per user - User detail: 75 requests per minute per user - User apps: 50 requests per minute per user - App list: 50 requests per minute per user - App analytics: 50 requests per minute per user Enterprise workspaces get 2x these limits. Rate limits are applied per authenticated user and enforced using token-bucket algorithm. version: 1.2.1 servers: - url: https://app.base44.com/api/v1/monitoring description: Monitoring API security: - ApiKeyAuth: [] tags: - name: analytics description: >- Workspace-level analytics and KPIs including usage, engagement, and cost metrics. - name: users description: User management, activity tracking, and credit consumption data. - name: apps description: App-level analytics, engagement metrics, and governance flags. - name: superagents description: Super Agent inventory and analytics. paths: /{workspace_id}/apps: get: tags: - apps summary: List apps description: >- Returns a paginated workspace-wide app inventory with owner, visibility, publish, activity, and credit-usage signals. This endpoint avoids client-side fan-out through every workspace user when building full app inventory views. operationId: list_apps__workspace_id__apps_get parameters: - name: workspace_id in: path required: true schema: type: string title: Workspace Id - name: limit in: query required: false schema: type: integer maximum: 50 minimum: 1 description: Items per page. Max 50. default: 50 title: Limit description: Items per page. Max 50. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Pagination cursor from previous response. title: Cursor description: Pagination cursor from previous response. - name: from in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Start date in `YYYY-MM-DD` format. Required if `to` is provided. Defaults to billing period start. title: From description: >- Start date in `YYYY-MM-DD` format. Required if `to` is provided. Defaults to billing period start. example: '2026-06-01' - name: to in: query required: false schema: anyOf: - type: string - type: 'null' description: >- End date in `YYYY-MM-DD` format. Required if `from` is provided. Defaults to current date. title: To description: >- End date in `YYYY-MM-DD` format. Required if `from` is provided. Defaults to current date. example: '2026-06-30' - name: sort in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Sort field. Prefix with `-` for descending. Supported fields: app_name, created_at, created_by_email, owner_user_id, last_published, is_published, views_last_30d, active_users_last_30d, message_credits_consumed, integration_credits_consumed, total_credits_consumed. title: Sort description: >- Sort field. Prefix with `-` for descending. Supported fields: app_name, created_at, created_by_email, owner_user_id, last_published, is_published, views_last_30d, active_users_last_30d, message_credits_consumed, integration_credits_consumed, total_credits_consumed. - name: search in: query required: false schema: anyOf: - type: string maxLength: 100 - type: 'null' description: Case-insensitive search over app name and creator email. title: Search description: Case-insensitive search over app name and creator email. - name: is_published in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Filter to published (`true`) or unpublished (`false`) apps. title: Is Published description: Filter to published (`true`) or unpublished (`false`) apps. - name: visibility in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Filter by app visibility. Accepts private, workspace, public_with_login, public_without_login, or public. title: Visibility description: >- Filter by app visibility. Accepts private, workspace, public_with_login, public_without_login, or public. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/WorkspaceAppListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: WorkspaceAppListResponse: properties: apps: items: $ref: '#/components/schemas/WorkspaceAppListItem' type: array title: Apps description: List of workspace apps. pagination: $ref: '#/components/schemas/PaginationMetadata' description: Pagination metadata. type: object required: - apps - pagination title: WorkspaceAppListResponse description: Paginated workspace app inventory. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError WorkspaceAppListItem: properties: app_id: type: string title: App Id description: App identifier. example: app_abc123 app_name: type: string title: App Name description: App name. example: Sales Dashboard owner_user_id: anyOf: - type: string - type: 'null' title: Owner User Id description: Current app owner user ID when known. example: user_abc123 created_by_email: anyOf: - type: string - type: 'null' title: Created By Email description: Email of the user who originally created the app. example: jane.doe@company.com created_at: anyOf: - type: string - type: 'null' title: Created At description: App creation date in `YYYY-MM-DDTHH:MM:SSZ` format. example: '2025-01-10T14:30:00Z' last_published: anyOf: - type: string - type: 'null' title: Last Published description: Last publish date in `YYYY-MM-DDTHH:MM:SSZ` format. example: '2025-01-10T14:30:00Z' is_published: type: boolean title: Is Published description: Whether the app has been published. example: true visibility: type: string title: Visibility description: >- App visibility, such as `"Public"`, `"Public (with login)"`, `"Workspace"`, or `"Private"`. example: Public (with login) views_last_30d: type: integer minimum: 0 title: Views Last 30D description: Views in the last 30 days. example: 1205 active_users_last_30d: type: integer minimum: 0 title: Active Users Last 30D description: Number of users who viewed the app in the last 30 days. example: 89 message_credits_consumed: type: number minimum: 0 title: Message Credits Consumed description: Message credits consumed by this app in the requested period. example: 4250 integration_credits_consumed: type: number minimum: 0 title: Integration Credits Consumed description: Integration credits consumed by this app in the requested period. example: 875 total_credits_consumed: type: number minimum: 0 title: Total Credits Consumed description: >- Combined message and integration credits consumed by this app in the requested period. example: 5125 type: object required: - app_id - app_name - is_published - visibility - views_last_30d - active_users_last_30d - message_credits_consumed - integration_credits_consumed - total_credits_consumed title: WorkspaceAppListItem description: Workspace app inventory row. PaginationMetadata: properties: total: type: integer title: Total description: Total number of items. example: 156 limit: type: integer title: Limit description: Number of items per page. example: 50 next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: >- Cursor for fetching the next page. The value is `null` if there are no more pages. example: eyJsYXN0X2lkIjoiMTIzIn0= has_more: type: boolean title: Has More description: Whether there are more items to fetch. example: true type: object required: - total - limit - has_more title: PaginationMetadata description: Metadata for paginated responses ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: api_key description: >- API key for authentication. See the Authentication page for your API for details on how to get your key. ````