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

# Get project analytics views

> Read one dashboard analytics report: token cost and usage estimates, public list price estimates, scorecards, tool aggregates, or ROI.



## OpenAPI

````yaml https://api.uselemma.ai/openapi.json get /projects/{project_id}/analytics/views
openapi: 3.1.0
info:
  title: Lemma Platform API
  description: Lemma Platform HTTP API for AI observability and workspace operations.
  version: 0.1.0
servers:
  - url: https://api.uselemma.ai
    description: Lemma production API
security:
  - bearerAuth: []
paths:
  /projects/{project_id}/analytics/views:
    get:
      tags:
        - Analytics
      summary: Get project analytics views
      description: >-
        Read one dashboard analytics report: token cost and usage estimates,
        public list price estimates, scorecards, tool aggregates, or ROI.
      operationId: get_project_analytics
      parameters:
        - name: project_id
          in: path
          required: true
          description: Project ID.
          schema:
            type: string
        - name: view
          in: query
          required: true
          description: Analytics view to return.
          schema:
            type: string
            enum:
              - base
              - window
              - model_scorecard
              - agent_scorecard
              - tool_aggregates
              - roi
        - name: start_inclusive
          in: query
          required: false
          description: Inclusive window start (ISO-8601).
          schema:
            type: string
        - name: end_exclusive
          in: query
          required: false
          description: Exclusive window end (ISO-8601).
          schema:
            type: string
        - name: max_bytes
          in: query
          required: false
          description: Optional response byte budget; maximum 65536.
          schema:
            type: integer
            minimum: 1
            maximum: 65536
        - name: granularity
          in: query
          required: false
          description: day, week, or month.
          schema:
            type: string
            enum:
              - day
              - week
              - month
      responses:
        '200':
          description: Project analytics view
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      view:
                        type: string
                        const: base
                      payload:
                        type: object
                        properties:
                          traces:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                value:
                                  type: number
                              required:
                                - date
                                - value
                              additionalProperties: false
                          errors:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                span_errors:
                                  type: number
                                failed_runs:
                                  type: number
                                root_status_known:
                                  type: number
                                root_absent:
                                  type: number
                                traces:
                                  type: number
                              required:
                                - date
                                - span_errors
                                - failed_runs
                                - root_status_known
                                - root_absent
                                - traces
                              additionalProperties: false
                          tokens:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                input_tokens:
                                  type: number
                                output_tokens:
                                  type: number
                              required:
                                - date
                                - input_tokens
                                - output_tokens
                              additionalProperties: false
                          cost:
                            type: array
                            items:
                              type: object
                              properties:
                                estimated_cost_usd:
                                  type:
                                    - number
                                    - 'null'
                                priced_token_share:
                                  type: number
                                priced_tokens:
                                  type: number
                                total_tokens:
                                  type: number
                                unpriced_models:
                                  type: array
                                  items:
                                    type: string
                                pricing_fetched_at:
                                  type:
                                    - string
                                    - 'null'
                                  format: date-time
                                cost_source:
                                  type: string
                                  enum:
                                    - stored
                                    - mixed
                                    - query_time
                                cost_lower_bound:
                                  type: boolean
                                cost_lower_bound_reasons:
                                  type: array
                                  items:
                                    type: string
                                    enum:
                                      - unpriced_models
                                      - prices_unavailable
                                      - unbackfilled_traces
                                      - live_priced_breakdown_truncated
                                      - model_rollup_truncated
                                model_breakdown_truncated:
                                  type: boolean
                                date:
                                  type: string
                                traces:
                                  type: number
                              required:
                                - estimated_cost_usd
                                - priced_token_share
                                - priced_tokens
                                - total_tokens
                                - unpriced_models
                                - pricing_fetched_at
                                - cost_source
                                - cost_lower_bound
                                - cost_lower_bound_reasons
                                - model_breakdown_truncated
                                - date
                                - traces
                              additionalProperties: false
                          cost_by_model:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                values:
                                  type: object
                                  additionalProperties:
                                    type: number
                                coverage:
                                  type: string
                                  enum:
                                    - all
                                    - unwritten_only
                                    - none
                                attributed_traces:
                                  type: number
                                traces:
                                  type: number
                              required:
                                - date
                                - values
                                - coverage
                                - attributed_traces
                                - traces
                              additionalProperties: false
                          cost_by_model_source:
                            type: string
                            const: query_time
                          cost_by_model_coverage:
                            type: string
                            enum:
                              - all
                              - unwritten_only
                              - none
                        required:
                          - traces
                          - errors
                          - tokens
                          - cost
                          - cost_by_model
                          - cost_by_model_source
                          - cost_by_model_coverage
                        additionalProperties: false
                    required:
                      - view
                      - payload
                    additionalProperties: false
                  - type: object
                    properties:
                      view:
                        type: string
                        const: window
                      payload:
                        type: object
                        properties:
                          latency:
                            type: object
                            properties:
                              granularity:
                                type: string
                                enum:
                                  - day
                                  - week
                                  - month
                              points:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type: string
                                    p50:
                                      type: number
                                    p95:
                                      type: number
                                  required:
                                    - date
                                    - p50
                                    - p95
                                  additionalProperties: false
                            required:
                              - granularity
                              - points
                            additionalProperties: false
                          totals:
                            type: object
                            properties:
                              p50:
                                type: number
                              p95:
                                type: number
                              failed_runs:
                                type: number
                              root_status_known:
                                type: number
                              root_absent:
                                type: number
                              traces:
                                type: number
                              error_rate:
                                type:
                                  - number
                                  - 'null'
                            required:
                              - p50
                              - p95
                              - failed_runs
                              - root_status_known
                              - root_absent
                              - traces
                              - error_rate
                            additionalProperties: false
                          coverage:
                            type:
                              - object
                              - 'null'
                            properties:
                              capability:
                                type: object
                                properties:
                                  root_status:
                                    type: boolean
                                  root_duration:
                                    type: boolean
                                  agents:
                                    type: boolean
                                  tokens:
                                    type: boolean
                                  model:
                                    type: boolean
                                  provider:
                                    type: boolean
                                  cost_basis:
                                    type: boolean
                                  tools:
                                    type: boolean
                                required:
                                  - root_status
                                  - root_duration
                                  - agents
                                  - tokens
                                  - model
                                  - provider
                                  - cost_basis
                                  - tools
                                additionalProperties: false
                              window:
                                type: object
                                properties:
                                  root_status:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      observed:
                                        type: number
                                      eligible:
                                        type: number
                                      is_lower_bound:
                                        type: boolean
                                    required:
                                      - observed
                                      - eligible
                                    additionalProperties: false
                                  root_duration:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      observed:
                                        type: number
                                      eligible:
                                        type: number
                                      is_lower_bound:
                                        type: boolean
                                    required:
                                      - observed
                                      - eligible
                                    additionalProperties: false
                                  agents:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      observed:
                                        type: number
                                      eligible:
                                        type: number
                                      is_lower_bound:
                                        type: boolean
                                    required:
                                      - observed
                                      - eligible
                                    additionalProperties: false
                                  tokens:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      observed:
                                        type: number
                                      eligible:
                                        type: number
                                      is_lower_bound:
                                        type: boolean
                                    required:
                                      - observed
                                      - eligible
                                    additionalProperties: false
                                  model:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      observed:
                                        type: number
                                      eligible:
                                        type: number
                                      is_lower_bound:
                                        type: boolean
                                    required:
                                      - observed
                                      - eligible
                                    additionalProperties: false
                                  provider:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      observed:
                                        type: number
                                      eligible:
                                        type: number
                                      is_lower_bound:
                                        type: boolean
                                    required:
                                      - observed
                                      - eligible
                                    additionalProperties: false
                                  cost_basis:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      observed:
                                        type: number
                                      eligible:
                                        type: number
                                      is_lower_bound:
                                        type: boolean
                                    required:
                                      - observed
                                      - eligible
                                    additionalProperties: false
                                  tools:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      observed:
                                        type: number
                                      eligible:
                                        type: number
                                      is_lower_bound:
                                        type: boolean
                                    required:
                                      - observed
                                      - eligible
                                    additionalProperties: false
                                required:
                                  - root_status
                                  - root_duration
                                  - agents
                                  - tokens
                                  - model
                                  - provider
                                  - cost_basis
                                  - tools
                                additionalProperties: false
                              window_traces:
                                type: number
                            required:
                              - capability
                              - window
                              - window_traces
                            additionalProperties: false
                          cost:
                            type: object
                            properties:
                              estimated_cost_usd:
                                type:
                                  - number
                                  - 'null'
                              priced_token_share:
                                type: number
                              priced_tokens:
                                type: number
                              total_tokens:
                                type: number
                              unpriced_models:
                                type: array
                                items:
                                  type: string
                              pricing_fetched_at:
                                type:
                                  - string
                                  - 'null'
                                format: date-time
                              cost_source:
                                type: string
                                enum:
                                  - stored
                                  - mixed
                                  - query_time
                              cost_lower_bound:
                                type: boolean
                              cost_lower_bound_reasons:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - unpriced_models
                                    - prices_unavailable
                                    - unbackfilled_traces
                                    - live_priced_breakdown_truncated
                                    - model_rollup_truncated
                              model_breakdown_truncated:
                                type: boolean
                              cost_rollup_truncated:
                                type: boolean
                              model_tokens_truncated:
                                type: boolean
                              unpriced_models_truncated:
                                type: boolean
                              cost_trace_counts:
                                type: object
                                properties:
                                  stored:
                                    type: number
                                  live_priced:
                                    type: number
                                  unbackfilled:
                                    type: number
                                  stored_unpriced:
                                    type: number
                                  stored_unavailable:
                                    type: number
                                  breakdown_truncated:
                                    type: number
                                required:
                                  - stored
                                  - live_priced
                                  - unbackfilled
                                  - stored_unpriced
                                  - stored_unavailable
                                  - breakdown_truncated
                                additionalProperties: false
                            required:
                              - estimated_cost_usd
                              - priced_token_share
                              - priced_tokens
                              - total_tokens
                              - unpriced_models
                              - pricing_fetched_at
                              - cost_source
                              - cost_lower_bound
                              - cost_lower_bound_reasons
                              - model_breakdown_truncated
                              - cost_rollup_truncated
                              - model_tokens_truncated
                              - unpriced_models_truncated
                              - cost_trace_counts
                            additionalProperties: false
                        required:
                          - latency
                          - totals
                          - coverage
                          - cost
                        additionalProperties: false
                    required:
                      - view
                      - payload
                    additionalProperties: false
                  - type: object
                    properties:
                      view:
                        type: string
                        const: model_scorecard
                      payload:
                        type: object
                        properties:
                          estimated_cost_usd:
                            type:
                              - number
                              - 'null'
                          priced_token_share:
                            type: number
                          priced_tokens:
                            type: number
                          total_tokens:
                            type: number
                          unpriced_models:
                            type: array
                            items:
                              type: string
                          pricing_fetched_at:
                            type:
                              - string
                              - 'null'
                            format: date-time
                          cost_source:
                            type: string
                            enum:
                              - stored
                              - mixed
                              - query_time
                          cost_lower_bound:
                            type: boolean
                          cost_lower_bound_reasons:
                            type: array
                            items:
                              type: string
                              enum:
                                - unpriced_models
                                - prices_unavailable
                                - unbackfilled_traces
                                - live_priced_breakdown_truncated
                                - model_rollup_truncated
                          model_breakdown_truncated:
                            type: boolean
                          cost_rollup_truncated:
                            type: boolean
                          cost_attribution_coverage:
                            type: string
                            enum:
                              - all
                              - unwritten_only
                              - none
                          cost_attribution_source:
                            type: string
                            const: query_time
                          rows:
                            type: array
                            items:
                              type: object
                              properties:
                                model:
                                  type: string
                                traces:
                                  type: number
                                tokens:
                                  type: number
                                input_tokens:
                                  type: number
                                output_tokens:
                                  type: number
                                avg_speed:
                                  type: number
                                priced:
                                  type: boolean
                                estimated_cost_usd:
                                  type:
                                    - number
                                    - 'null'
                              required:
                                - model
                                - traces
                                - tokens
                                - input_tokens
                                - output_tokens
                                - avg_speed
                                - priced
                                - estimated_cost_usd
                              additionalProperties: false
                        required:
                          - estimated_cost_usd
                          - priced_token_share
                          - priced_tokens
                          - total_tokens
                          - unpriced_models
                          - pricing_fetched_at
                          - cost_source
                          - cost_lower_bound
                          - cost_lower_bound_reasons
                          - model_breakdown_truncated
                          - cost_rollup_truncated
                          - cost_attribution_coverage
                          - cost_attribution_source
                          - rows
                        additionalProperties: false
                    required:
                      - view
                      - payload
                    additionalProperties: false
                  - type: object
                    properties:
                      view:
                        type: string
                        const: agent_scorecard
                      payload:
                        type: object
                        properties:
                          rows:
                            type: array
                            items:
                              type: object
                              properties:
                                agent:
                                  type: string
                                traces:
                                  type: number
                                p50:
                                  type: number
                                p95:
                                  type: number
                                error_rate:
                                  type:
                                    - number
                                    - 'null'
                                root_status_known:
                                  type: number
                                tools_used:
                                  type: number
                                tools_used_is_lower_bound:
                                  type: boolean
                                tokens:
                                  type: number
                                cost:
                                  type:
                                    - number
                                    - 'null'
                                cost_is_lower_bound:
                                  type: boolean
                                cost_source:
                                  type: string
                                  enum:
                                    - stored
                                    - mixed
                                    - query_time
                                cost_lower_bound_reasons:
                                  type: array
                                  items:
                                    type: string
                                    enum:
                                      - unpriced_models
                                      - prices_unavailable
                                      - unbackfilled_traces
                                      - live_priced_breakdown_truncated
                                      - model_rollup_truncated
                                model_breakdown_truncated:
                                  type: boolean
                              required:
                                - agent
                                - traces
                                - p50
                                - p95
                                - error_rate
                                - root_status_known
                                - tools_used
                                - tools_used_is_lower_bound
                                - tokens
                                - cost
                                - cost_is_lower_bound
                                - cost_source
                                - cost_lower_bound_reasons
                                - model_breakdown_truncated
                              additionalProperties: false
                        required:
                          - rows
                        additionalProperties: false
                    required:
                      - view
                      - payload
                    additionalProperties: false
                  - type: object
                    properties:
                      view:
                        type: string
                        const: tool_aggregates
                      payload:
                        type: object
                        properties:
                          comparison:
                            type: array
                            items:
                              type: object
                              properties:
                                tool:
                                  type: string
                                calls:
                                  type: number
                                errors:
                                  type: number
                                p50:
                                  type: number
                                p95:
                                  type: number
                                traces:
                                  type: number
                                traces_is_lower_bound:
                                  type: boolean
                                output_tokens:
                                  type: number
                                error_rate:
                                  type:
                                    - number
                                    - 'null'
                              required:
                                - tool
                                - calls
                                - errors
                                - p50
                                - p95
                                - traces
                                - traces_is_lower_bound
                                - output_tokens
                                - error_rate
                              additionalProperties: false
                          volume:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                values:
                                  type: object
                                  additionalProperties:
                                    type: number
                              required:
                                - date
                                - values
                              additionalProperties: false
                          failing_volume:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                values:
                                  type: object
                                  additionalProperties:
                                    type: number
                              required:
                                - date
                                - values
                              additionalProperties: false
                          error_concentration:
                            type: object
                            properties:
                              rows:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    span_name:
                                      type: string
                                    errors:
                                      type: number
                                    rate:
                                      type: number
                                  required:
                                    - span_name
                                    - errors
                                    - rate
                                  additionalProperties: false
                              total_error_spans:
                                type: number
                              truncated:
                                type: boolean
                            required:
                              - rows
                              - total_error_spans
                              - truncated
                            additionalProperties: false
                        required:
                          - comparison
                          - volume
                          - failing_volume
                          - error_concentration
                        additionalProperties: false
                    required:
                      - view
                      - payload
                    additionalProperties: false
                  - type: object
                    properties:
                      view:
                        type: string
                        const: roi
                      payload:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - connect
                              - waiting
                              - populated
                          counts:
                            type: object
                            properties:
                              agents:
                                type: number
                              lifetime_traces:
                                type: number
                              issues:
                                type: number
                              resolved:
                                type: number
                            required:
                              - agents
                              - lifetime_traces
                              - issues
                              - resolved
                            additionalProperties: false
                          base:
                            type: object
                            properties:
                              caught:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type: string
                                    value:
                                      type: number
                                  required:
                                    - date
                                    - value
                                  additionalProperties: false
                              resolved:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type: string
                                    value:
                                      type: number
                                  required:
                                    - date
                                    - value
                                  additionalProperties: false
                              dismissed:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type: string
                                    value:
                                      type: number
                                  required:
                                    - date
                                    - value
                                  additionalProperties: false
                              traces:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type: string
                                    value:
                                      type: number
                                  required:
                                    - date
                                    - value
                                  additionalProperties: false
                              errors:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type: string
                                    value:
                                      type: number
                                  required:
                                    - date
                                    - value
                                  additionalProperties: false
                              artifact_iterations:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type: string
                                    value:
                                      type: number
                                  required:
                                    - date
                                    - value
                                  additionalProperties: false
                              resolution_days:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type: string
                                    value:
                                      type: number
                                  required:
                                    - date
                                    - value
                                  additionalProperties: false
                            required:
                              - caught
                              - resolved
                              - dismissed
                              - traces
                              - errors
                              - artifact_iterations
                              - resolution_days
                            additionalProperties: false
                        required:
                          - state
                          - counts
                          - base
                        additionalProperties: false
                    required:
                      - view
                      - payload
                    additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                required:
                  - detail
                additionalProperties: false
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                required:
                  - detail
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                required:
                  - detail
                additionalProperties: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                required:
                  - detail
                additionalProperties: false
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                required:
                  - detail
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.