> ## Documentation Index > Fetch the complete documentation index at: https://platform.atlan.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the SDK. To install or publish skills from a terminal, use the `aireg` CLI; `aireg --map json` prints its command map. The `atlanai` CLI is deprecated. Run a read-only identity check before any write. > The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects. > SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript. > These docs cover Atlan AI Registry, Atlan's hosted product. The AI registry specification and aireg CLI are maintained separately. /open-source lists publicly reachable signed installers and explains that the source repository and hosted CLI reference currently require GitHub access. Do not claim the repository or its reference docs are publicly accessible. Use these docs for Atlan-specific setup such as the adapter, sign-in and workspaces. # Query statistics over an experiment's traces ## OpenAPI ````yaml /public-openapi.json post /eval/v1/experiments/{experiment_id}/traces/stats/query openapi: 3.1.0 info: title: Atlan public API version: current description: >- Public HTTP API reference for Registry, Skills, Agents, outputs, files, MCP servers and tools, and OTLP telemetry ingestion. servers: - url: https://api.atlan.com description: Atlan API base URL security: - bearer: [] tags: - name: Core - name: Skill - name: Agent - name: Files - name: Knowledge - name: MCP - name: Observability - name: API proxy - name: Credentials - name: Store - name: Apps - name: Evals - name: Ontologies - name: Ontology bindings - name: Slack - name: GitHub - name: Objectives - name: Repositories paths: /eval/v1/experiments/{experiment_id}/traces/stats/query: post: tags: - Evals summary: Query statistics over an experiment's traces operationId: eval.queryExperimentTraceStats parameters: - name: experiment_id in: path required: true schema: type: string - name: Content-Encoding in: header required: false schema: type: string enum: - base64 - gzip, base64 requestBody: content: application/json: schema: $ref: '#/components/schemas/eval-gateway-TraceStatsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/eval-gateway-TraceStatsEnvelope' description: HTTP 200 response. '400': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - invalid_base64 - invalid_gzip - invalid_json description: HTTP 400 response. '401': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - alg_mismatch - alg_not_allowed - audience_mismatch - invalid_api_key - missing_identity - missing_org - missing_user - signature_invalid - token_expired - token_malformed - token_missing - token_not_yet_valid - token_rejected - token_service_account_unbound - unauthorized - unknown_account - unknown_key - untrusted_issuer description: HTTP 401 response. '403': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - access_denied - account_suspended - forbidden - platform_principal_refused description: HTTP 403 response. '404': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - not_found description: HTTP 404 response. '413': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - compressed_payload_too_large - decompressed_payload_too_large - payload_too_large description: HTTP 413 response. '415': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - unsupported_content_encoding - unsupported_content_type description: HTTP 415 response. '422': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - validation_failed description: HTTP 422 response. '500': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - internal_error description: HTTP 500 response. '503': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - auth_unavailable - service_overloaded description: HTTP 503 response. '504': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - request_timeout description: HTTP 504 response. components: schemas: eval-gateway-TraceStatsRequest: type: object required: - start_time_unix_seconds - end_time_unix_seconds - request_type - queries properties: bucket: oneOf: - $ref: '#/components/schemas/eval-gateway-TraceStatsBucket' - type: 'null' compare: oneOf: - $ref: '#/components/schemas/eval-gateway-TraceStatsCompareMode' - type: 'null' end_time_unix_seconds: type: integer format: int64 queries: type: array items: $ref: '#/components/schemas/eval-gateway-TraceStatsPanelQuery' request_type: $ref: '#/components/schemas/eval-gateway-TraceStatsRequestType' start_time_unix_seconds: type: integer format: int64 workspace_id: type: - string - 'null' eval-gateway-TraceStatsEnvelope: type: object required: - data - meta properties: comparison: oneOf: - $ref: '#/components/schemas/eval-gateway-TraceStatsComparison' - type: 'null' data: $ref: '#/components/schemas/eval-gateway-TraceStatsData' meta: $ref: '#/components/schemas/eval-gateway-TraceStatsMeta' eval-ProblemDetails: type: object required: - title - status - detail - code properties: code: type: string detail: type: string status: type: integer format: int32 minimum: 0 title: type: string trace_id: type: - string - 'null' eval-gateway-TraceStatsBucket: type: string enum: - day - week eval-gateway-TraceStatsCompareMode: type: string enum: - none - previous_period eval-gateway-TraceStatsPanelQuery: type: object required: - name - measure properties: filters: type: array items: $ref: '#/components/schemas/eval-gateway-TraceStatsFilter' group_by: type: array items: $ref: '#/components/schemas/eval-gateway-TraceStatsGroupBy' limit: type: - integer - 'null' format: int32 minimum: 0 measure: $ref: '#/components/schemas/eval-gateway-TraceStatsMeasure' name: type: string order: oneOf: - $ref: '#/components/schemas/eval-gateway-TraceStatsOrder' - type: 'null' eval-gateway-TraceStatsRequestType: type: string enum: - scalar - table - time_series eval-gateway-TraceStatsComparison: type: object required: - start_time_unix_seconds - end_time_unix_seconds - data properties: data: $ref: '#/components/schemas/eval-gateway-TraceStatsData' end_time_unix_seconds: type: integer format: int64 start_time_unix_seconds: type: integer format: int64 eval-gateway-TraceStatsData: oneOf: - type: object required: - results - request_type properties: request_type: type: string enum: - scalar results: type: array items: $ref: '#/components/schemas/eval-gateway-TraceStatsScalarResult' - type: object required: - columns - rows - request_type properties: columns: type: array items: $ref: '#/components/schemas/eval-gateway-TraceStatsTableColumn' request_type: type: string enum: - table rows: type: array items: $ref: '#/components/schemas/eval-gateway-TraceStatsTableRow' - type: object required: - series - request_type properties: request_type: type: string enum: - time_series series: type: array items: $ref: '#/components/schemas/eval-gateway-TraceStatsSeries' eval-gateway-TraceStatsMeta: type: object properties: as_of_unix_seconds: type: - integer - 'null' format: int64 warnings: type: array items: type: string window: oneOf: - $ref: '#/components/schemas/eval-gateway-TraceStatsWindow' - type: 'null' eval-gateway-TraceStatsFilter: type: object required: - key - op properties: key: $ref: '#/components/schemas/eval-gateway-TraceStatsGroupBy' op: $ref: '#/components/schemas/eval-gateway-TraceStatsFilterOperator' value: $ref: '#/components/schemas/eval-gateway-TraceStatsFilterValue' eval-gateway-TraceStatsGroupBy: type: string enum: - harness - skill - skill_version - command - mcp - tool - model - user - experiment - score_name - scorer - scorer_version eval-gateway-TraceStatsMeasure: type: string enum: - sessions - traces - spans - skill_invocations - tool_calls - tokens - uncached_input_tokens - cached_input_tokens - cache_write_tokens - output_tokens - active_users - active_visitors - error_rate - success_rate - tokens_per_trace - cost - latency_p50 - latency_p90 - latency_p99 - score_value - scores eval-gateway-TraceStatsOrder: type: object required: - by - direction properties: by: $ref: '#/components/schemas/eval-gateway-TraceStatsOrderBy' direction: $ref: '#/components/schemas/eval-gateway-TraceStatsOrderDirection' eval-gateway-TraceStatsScalarResult: type: object required: - query_name - measure properties: measure: $ref: '#/components/schemas/eval-gateway-TraceStatsMeasure' query_name: type: string unit: type: - string - 'null' value: type: - number - 'null' format: double eval-gateway-TraceStatsTableColumn: type: object required: - name - column_type properties: column_type: $ref: '#/components/schemas/eval-gateway-TraceStatsTableColumnType' name: type: string unit: type: - string - 'null' eval-gateway-TraceStatsTableRow: type: object required: - groups - values properties: groups: {} values: {} eval-gateway-TraceStatsSeries: type: object required: - query_name - measure - points properties: measure: $ref: '#/components/schemas/eval-gateway-TraceStatsMeasure' points: type: array items: $ref: '#/components/schemas/eval-gateway-TraceStatsSeriesPoint' query_name: type: string unit: type: - string - 'null' eval-gateway-TraceStatsWindow: type: object required: - start_time_unix_seconds - end_time_unix_seconds properties: end_time_unix_seconds: type: integer format: int64 start_time_unix_seconds: type: integer format: int64 eval-gateway-TraceStatsFilterOperator: type: string enum: - eq - neq - in - exists - not_exists eval-gateway-TraceStatsFilterValue: oneOf: - type: string - type: number format: double - type: boolean - type: array items: type: string - type: array items: type: number format: double - type: array items: type: boolean eval-gateway-TraceStatsOrderBy: type: string enum: - value - name eval-gateway-TraceStatsOrderDirection: type: string enum: - asc - desc eval-gateway-TraceStatsTableColumnType: type: string enum: - group - measure eval-gateway-TraceStatsSeriesPoint: type: object required: - timestamp_unix_seconds properties: timestamp_unix_seconds: type: integer format: int64 value: type: - number - 'null' format: double securitySchemes: bearer: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.