> ## Documentation Index > Fetch the complete documentation index at: https://docs.domino.ai/llms.txt > Use this file to discover all available pages before exploring further. # List traces > List traces for an AI system version, applying the same server-side filter grammar as the chart endpoints (including numeric range filters on eval-metric tags). Returns MLflow-trace-compatible rows with token-based pagination. ## OpenAPI ````yaml /api-specs/cloud/public-api.json get /api/model-services/v1/aisystem/{system_id}/version/{version_id}/traces openapi: 3.0.3 info: title: Domino Public API description: Reference for Domino's public REST API endpoints. version: 6.4.0 x-catalog-key: nucleus servers: - url: https://mycluster.domino.tech description: >- Replace 'mycluster.domino.tech' with your Domino cluster hostname. For Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g., acme.domino.tech). For self-hosted deployments, it is the hostname you reach the Domino UI at. security: [] tags: - name: Projects - name: Project templates - name: Workspaces - name: Jobs - name: HPC Jobs - name: Environments - name: Hardware Tiers - name: Datasets - name: Data Sources - name: GenAI - name: AI Systems - name: Apps - name: App versions - name: App instances - name: Model APIs - name: Registered models - name: Model deployment - name: Extensions - name: Cost and billing - name: Users and organizations - name: Service accounts - name: Personal Access Tokens - name: Personal Access Tokens (admin) - name: Audit Trail - name: Custom metrics - name: PPM - name: Model Monitoring models - name: Model Monitoring drift and quality - name: Model Monitoring settings - name: Model Monitoring authentication - name: Governance bundles - name: Governance policies - name: Governance evidence and results - name: Governance operations - name: NetApp Volumes - name: NetApp Volumes snapshots - name: NetApp Volumes filesystems - name: NetApp Volumes transfers - name: Tags - name: Properties externalDocs: description: OpenAPI url: https://swagger.io/resources/open-api/ paths: /api/model-services/v1/aisystem/{system_id}/version/{version_id}/traces: get: tags: - AI Systems summary: List traces description: >- List traces for an AI system version, applying the same server-side filter grammar as the chart endpoints (including numeric range filters on eval-metric tags). Returns MLflow-trace-compatible rows with token-based pagination. operationId: get_traces parameters: - in: path name: system_id required: true schema: type: string - in: path name: version_id required: true schema: type: string - description: >- Optional URL-encoded JSON filter. Same grammar as the chart endpoints. See the /filters endpoint for available fields. explode: false in: query name: filter schema: description: >- Optional URL-encoded JSON filter. Same grammar as the chart endpoints. See the /filters endpoint for available fields. type: string - description: >- Inclusive lower bound on trace time in RFC3339 format. Defaults to 7 days ago if not specified. explode: false in: query name: start_time schema: description: >- Inclusive lower bound on trace time in RFC3339 format. Defaults to 7 days ago if not specified. format: date-time type: string - description: >- Inclusive upper bound on trace time in RFC3339 format. Defaults to now if not specified. explode: false in: query name: end_time schema: description: >- Inclusive upper bound on trace time in RFC3339 format. Defaults to now if not specified. format: date-time type: string - description: >- Field to sort by. Accepts 'timestamp_ms', 'execution_time_ms', or any eval-metric facet (sorted numerically, e.g. accuracy_score) or categorical-label facet (sorted lexically, e.g. topic) name from the /filters endpoint. Defaults to 'timestamp_ms'. explode: false in: query name: order_by schema: description: >- Field to sort by. Accepts 'timestamp_ms', 'execution_time_ms', or any eval-metric facet (sorted numerically, e.g. accuracy_score) or categorical-label facet (sorted lexically, e.g. topic) name from the /filters endpoint. Defaults to 'timestamp_ms'. type: string - description: Sort direction. Defaults to 'DESC'. explode: false in: query name: order_direction schema: description: Sort direction. Defaults to 'DESC'. enum: - ASC - DESC type: string - description: Page size. Defaults to 20, capped at 100. explode: false in: query name: max_results schema: description: Page size. Defaults to 20, capped at 100. format: int32 type: integer - description: Opaque pagination token from a previous response's next_page_token. explode: false in: query name: page_token schema: description: >- Opaque pagination token from a previous response's next_page_token. type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/mlflow-proxy_GetTracesResponseBody' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/mlflow-proxy_ErrorModel' description: Error components: schemas: mlflow-proxy_GetTracesResponseBody: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. example: /api/model-services/v1/aisystem/schemas/GetTracesResponseBody.json format: uri readOnly: true type: string next_page_token: description: >- Opaque token for fetching the next page. Omitted/empty on the last page. type: string traces: description: Page of MLflow-trace-compatible rows. items: $ref: '#/components/schemas/mlflow-proxy_Trace' nullable: true type: array required: - traces type: object mlflow-proxy_ErrorModel: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. example: /api/model-services/v1/aisystem/schemas/ErrorModel.json format: uri readOnly: true type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. example: Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/mlflow-proxy_ErrorDetail' nullable: true type: array instance: description: >- A URI reference that identifies the specific occurrence of the problem. example: https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code example: 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. example: Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. example: https://example.com/errors/example format: uri type: string type: object mlflow-proxy_Trace: additionalProperties: false properties: execution_time_ms: description: >- Trace duration in milliseconds. Omitted for traces that have not ended (no recorded duration). format: int64 type: integer experiment_id: description: MLflow experiment id the trace belongs to. type: string request_id: description: MLflow trace request id. type: string request_metadata: description: MLflow trace request-metadata entries. items: $ref: '#/components/schemas/mlflow-proxy_TraceKeyValue' nullable: true type: array status: description: Trace status. type: string tags: description: MLflow trace tags. items: $ref: '#/components/schemas/mlflow-proxy_TraceKeyValue' nullable: true type: array timestamp_ms: description: Trace start time in epoch milliseconds. format: int64 type: integer required: - request_id - experiment_id - timestamp_ms - status - request_metadata - tags type: object mlflow-proxy_ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object mlflow-proxy_TraceKeyValue: additionalProperties: false properties: key: description: Tag or request-metadata key. type: string value: description: Tag or request-metadata value. type: string required: - key - value type: object ```` ## Related topics - [The python-domino library](/cloud/reference/python-sdk/python-domino.md) - [API reference for the Agents Python SDK](/cloud/reference/experiment-agent-sdk/python-sdk-agents.md) - [Get trace count timeseries](/api-reference/ai-systems/get-trace-count-timeseries.md) - [Monitor agentic systems](/cloud/platform-capabilities/features/agents/monitor.md)