> ## 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.

# Get Superagent analytics

> Returns detailed analytics for the specified Superagent, including active-user and credit-usage metrics.

    Get `agent_id` values from [`List Superagents`](/api-reference/superagents/list-superagents) or [`List user Superagents`](/api-reference/users/list-user-superagents).



## OpenAPI

````yaml /developers/references/monitoring-api/monitoring-openapi.json get /{workspace_id}/superagents/{agent_id}/analytics
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
        - User Superagents: 50 requests per minute per user
        - App list: 50 requests per minute per user
        - App analytics: 50 requests per minute per user
        - Superagent list: 50 requests per minute per user
        - Superagent 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: Superagent inventory and analytics.
paths:
  /{workspace_id}/superagents/{agent_id}/analytics:
    get:
      tags:
        - superagents
      summary: Get Superagent analytics
      description: >-
        Returns detailed analytics for the specified Superagent, including
        active-user and credit-usage metrics.

            Get `agent_id` values from [`List Superagents`](/api-reference/superagents/list-superagents) or [`List user Superagents`](/api-reference/users/list-user-superagents).
      operationId: >-
        get_superagent_analytics__workspace_id__superagents__agent_id__analytics_get
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
            title: Workspace Id
        - name: agent_id
          in: path
          required: true
          schema:
            type: string
            description: Superagent ID.
            title: Agent Id
          description: Superagent ID.
        - name: from
          in: query
          required: true
          schema:
            type: string
            description: Start date in `YYYY-MM-DD` format.
            title: From
          description: Start date in `YYYY-MM-DD` format.
          example: '2026-06-01'
        - name: to
          in: query
          required: true
          schema:
            type: string
            description: End date in `YYYY-MM-DD` format.
            title: To
          description: End date in `YYYY-MM-DD` format.
          example: '2026-06-30'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuperAgentAnalytics'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SuperAgentAnalytics:
      properties:
        superagent_id:
          type: string
          title: Superagent Id
          description: Superagent identifier.
          example: agent_abc123
        superagent_name:
          type: string
          title: Superagent Name
          description: Superagent name.
          example: Support Agent
        active_users_last_7d:
          type: integer
          minimum: 0
          title: Active Users Last 7D
          description: >-
            Approximate number of distinct users who sent messages to this
            Superagent in the last 7 days. Users who cannot be individually
            identified, such as users messaging through external channels, are
            counted as one user per conversation.
          example: 42
        active_users_last_30d:
          type: integer
          minimum: 0
          title: Active Users Last 30D
          description: >-
            Approximate number of distinct users who sent messages to this
            Superagent in the last 30 days. Users who cannot be individually
            identified, such as users messaging through external channels, are
            counted as one user per conversation.
          example: 89
        message_credits_consumed:
          type: number
          minimum: 0
          title: Message Credits Consumed
          description: Message credits consumed by this Superagent in the requested period.
          example: 4250
        integration_credits_consumed:
          type: number
          minimum: 0
          title: Integration Credits Consumed
          description: >-
            Integration credits consumed by this Superagent in the requested
            period.
          example: 875
      type: object
      required:
        - superagent_id
        - superagent_name
        - active_users_last_7d
        - active_users_last_30d
        - message_credits_consumed
        - integration_credits_consumed
      title: SuperAgentAnalytics
      description: Detailed analytics for a specific Superagent.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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.

````