> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formbharo.artpark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Workspace Analytics

> The same numbers rolled up over a workspace, plus a per-agent breakdown.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/workspaces/{workspace_id}/analytics
openapi: 3.1.0
info:
  description: >
    Create and run form-filling voice agents, and read back the conversations
    they had.


    Send your API key on every request as `Authorization: Bearer fb_live_...`.

    A key belongs to one workspace and only reaches that workspace's agents.
    Create

    and revoke keys from Settings in the web app; keys cannot manage other keys.
  title: FormBharo API
  version: 1.0.0
servers:
  - description: Production
    url: https://form-fill-agent-backend.artpark.ai
security:
  - apiKey: []
paths:
  /api/v1/workspaces/{workspace_id}/analytics:
    get:
      tags:
        - Analytics
      summary: Get Workspace Analytics
      description: The same numbers rolled up over a workspace, plus a per-agent breakdown.
      operationId: get_workspace_analytics_api_v1_workspaces__workspace_id__analytics_get
      parameters:
        - in: path
          name: workspace_id
          required: true
          schema:
            title: Workspace Id
            type: string
        - in: query
          name: status
          required: false
          schema:
            anyOf:
              - enum:
                  - complete
                  - screened_out
                  - failed
                  - in_progress
                type: string
              - type: 'null'
            title: Status
        - in: query
          name: source
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Source
        - description: >-
            Unix seconds; created_at >= since. Note: created_at is the last time
            the call's answers were written, not when the call happened, so a
            call edited later moves.
          in: query
          name: since
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: >-
              Unix seconds; created_at >= since. Note: created_at is the last
              time the call's answers were written, not when the call happened,
              so a call edited later moves.
            title: Since
        - description: >-
            Unix seconds; created_at <= until. Note: created_at is the last time
            the call's answers were written, not when the call happened, so a
            call edited later moves.
          in: query
          name: until
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: >-
              Unix seconds; created_at <= until. Note: created_at is the last
              time the call's answers were written, not when the call happened,
              so a call edited later moves.
            title: Until
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceAnalytics'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    WorkspaceAnalytics:
      properties:
        agents:
          items:
            $ref: '#/components/schemas/AgentAnalytics'
          title: Agents
          type: array
        stats:
          $ref: '#/components/schemas/AnalyticsStats'
        workspace_id:
          title: Workspace Id
          type: string
        workspace_name:
          title: Workspace Name
          type: string
      required:
        - workspace_id
        - workspace_name
        - stats
        - agents
      title: WorkspaceAnalytics
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    AgentAnalytics:
      properties:
        agent_id:
          title: Agent Id
          type: string
        agent_title:
          title: Agent Title
          type: string
        stats:
          $ref: '#/components/schemas/AnalyticsStats'
      required:
        - agent_id
        - agent_title
        - stats
      title: AgentAnalytics
      type: object
    AnalyticsStats:
      properties:
        ack_latency_sample_count:
          title: Ack Latency Sample Count
          type: integer
        ack_to_reply_sample_count:
          title: Ack To Reply Sample Count
          type: integer
        attempted:
          title: Attempted
          type: integer
        avg_ack_latency_ci95:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Ack Latency Ci95
        avg_ack_latency_secs:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Ack Latency Secs
        avg_ack_to_reply_ci95:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Ack To Reply Ci95
        avg_ack_to_reply_secs:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Ack To Reply Secs
        avg_duration_ci95:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Duration Ci95
        avg_duration_secs:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Duration Secs
        completed:
          title: Completed
          type: integer
        completion_rate:
          title: Completion Rate
          type: number
        cost:
          $ref: '#/components/schemas/CostStats'
        duration_sample_count:
          title: Duration Sample Count
          type: integer
        screened_out:
          title: Screened Out
          type: integer
      required:
        - attempted
        - completed
        - screened_out
        - completion_rate
        - avg_duration_secs
        - avg_duration_ci95
        - avg_ack_latency_secs
        - avg_ack_latency_ci95
        - avg_ack_to_reply_secs
        - avg_ack_to_reply_ci95
        - duration_sample_count
        - ack_latency_sample_count
        - ack_to_reply_sample_count
        - cost
      title: AnalyticsStats
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    CostStats:
      properties:
        call_count:
          title: Call Count
          type: integer
        llm:
          $ref: '#/components/schemas/CostComponentAverages'
        stt:
          $ref: '#/components/schemas/CostComponentAverages'
        total:
          $ref: '#/components/schemas/CostComponentAverages'
        tts:
          $ref: '#/components/schemas/CostComponentAverages'
      required:
        - call_count
        - total
        - llm
        - stt
        - tts
      title: CostStats
      type: object
    CostComponentAverages:
      description: Averages for one cost component (USD), per call and per turn.
      properties:
        per_call:
          anyOf:
            - type: number
            - type: 'null'
          title: Per Call
        per_turn:
          anyOf:
            - type: number
            - type: 'null'
          title: Per Turn
      required:
        - per_call
        - per_turn
      title: CostComponentAverages
      type: object
  securitySchemes:
    apiKey:
      bearerFormat: fb_live_...
      scheme: bearer
      type: http

````