> ## Documentation Index > Fetch the complete documentation index at: https://docs.pandaprobe.com/llms.txt > Use this file to discover all available pages before exploring further. # List Trace Scores > List trace scores (summary view) with comprehensive filters. Auth: ``Bearer`` + ``X-Project-ID`` | ``X-API-Key`` + ``X-Project-Name`` ## OpenAPI ````yaml /openapi.json get /evaluations/trace-scores openapi: 3.1.0 info: title: PandaProbe API description: >- Open-source agent engineering platform — trace LLM calls, evaluate agent performance, and monitor AI pipelines. version: 0.1.0 contact: name: PandaProbe url: https://www.pandaprobe.com email: support@pandaprobe.com servers: - url: https://api.pandaprobe.com description: Production security: [] tags: - name: health description: Service health and readiness probes. - name: user description: Authenticated user profile. - name: traces description: Trace ingestion, querying, updating, and analytics. - name: sessions description: Session-based trace aggregation and analytics. - name: evaluations description: Evaluation runs, scores, analytics, and monitoring. - name: organizations description: Organization management and membership. - name: projects description: Project CRUD within organizations. - name: api-keys description: API key lifecycle management. paths: /evaluations/trace-scores: get: tags: - evaluations summary: List Trace Scores description: |- List trace scores (summary view) with comprehensive filters. Auth: ``Bearer`` + ``X-Project-ID`` | ``X-API-Key`` + ``X-Project-Name`` operationId: list_trace_scores_evaluations_trace_scores_get parameters: - name: trace_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter by trace UUID title: Trace Id description: Filter by trace UUID - name: name in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by metric name (exact match) title: Name description: Filter by metric name (exact match) - name: source in: query required: false schema: anyOf: - $ref: '#/components/schemas/ScoreSource' - type: 'null' description: 'Filter by score source: AUTOMATED, ANNOTATION, PROGRAMMATIC' title: Source description: 'Filter by score source: AUTOMATED, ANNOTATION, PROGRAMMATIC' - name: status in: query required: false schema: anyOf: - $ref: '#/components/schemas/ScoreStatus' - type: 'null' description: 'Filter by score status: SUCCESS, FAILED, PENDING' title: Status description: 'Filter by score status: SUCCESS, FAILED, PENDING' - name: data_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/ScoreDataType' - type: 'null' description: 'Filter by data type: NUMERIC, BOOLEAN, CATEGORICAL' title: Data Type description: 'Filter by data type: NUMERIC, BOOLEAN, CATEGORICAL' - name: eval_run_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter by eval run UUID title: Eval Run Id description: Filter by eval run UUID - name: environment in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by trace environment (exact match) title: Environment description: Filter by trace environment (exact match) - name: date_from in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: ISO 8601 datetime. Include scores created on or after. title: Date From description: ISO 8601 datetime. Include scores created on or after. - name: date_to in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: ISO 8601 datetime. Include scores created before (exclusive). title: Date To description: ISO 8601 datetime. Include scores created before (exclusive). - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 description: Page size default: 50 title: Limit description: Page size - name: offset in: query required: false schema: type: integer minimum: 0 description: Number of items to skip default: 0 title: Offset description: Number of items to skip responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_TraceScoreResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] - ApiKey: [] - ProjectID: [] - ProjectName: [] components: schemas: ScoreSource: type: string enum: - AUTOMATED - ANNOTATION - PROGRAMMATIC title: ScoreSource description: |- Who produced the score judgment (not how it arrived). AUTOMATED -- the eval system's LLM judge produced this score ANNOTATION -- a human assigned this score manually PROGRAMMATIC -- external code submitted this score via API/SDK ScoreStatus: type: string enum: - SUCCESS - FAILED - PENDING title: ScoreStatus description: Outcome of a trace score evaluation attempt. ScoreDataType: type: string enum: - NUMERIC - BOOLEAN - CATEGORICAL title: ScoreDataType description: Data type for a trace score value. PaginatedResponse_TraceScoreResponse_: properties: items: items: $ref: '#/components/schemas/TraceScoreResponse' type: array title: Items total: type: integer title: Total limit: type: integer title: Limit offset: type: integer title: Offset type: object required: - items - total - limit - offset title: PaginatedResponse[TraceScoreResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TraceScoreResponse: properties: id: type: string format: uuid title: Id trace_id: type: string format: uuid title: Trace Id name: type: string title: Name value: anyOf: - type: string - type: 'null' title: Value status: $ref: '#/components/schemas/ScoreStatus' source: $ref: '#/components/schemas/ScoreSource' created_at: type: string title: Created At project_id: type: string format: uuid title: Project Id data_type: $ref: '#/components/schemas/ScoreDataType' eval_run_id: anyOf: - type: string format: uuid - type: 'null' title: Eval Run Id author_user_id: anyOf: - type: string - type: 'null' title: Author User Id reason: anyOf: - type: string - type: 'null' title: Reason environment: anyOf: - type: string - type: 'null' title: Environment config_id: anyOf: - type: string - type: 'null' title: Config Id metadata: additionalProperties: true type: object title: Metadata updated_at: type: string title: Updated At type: object required: - id - trace_id - name - value - status - source - created_at - project_id - data_type - eval_run_id - author_user_id - reason - environment - config_id - metadata - updated_at title: TraceScoreResponse description: Full trace score representation used by both list and detail endpoints. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ApiKey: type: apiKey in: header name: X-API-Key ProjectID: type: apiKey in: header name: X-Project-ID ProjectName: type: apiKey in: header name: X-Project-Name ````