> ## Documentation Index > Fetch the complete documentation index at: https://doc.featherhq.com/llms.txt > Use this file to discover all available pages before exploring further. # List eval runs ## OpenAPI ````yaml /api-reference/openapi.json get /v1/eval-runs openapi: 3.1.0 info: title: Feather API description: >- Unified customer experience platform API. Manages identity, conversations, memory, agents, procedures, policies, model routing, knowledge bases, integrations, and runtime execution. version: 1.21.0 servers: - url: https://api-sandbox.featherhq.com description: Sandbox - url: http://localhost:8000 description: Local dev security: [] paths: /v1/eval-runs: get: tags: - evals - evals summary: List eval runs operationId: listEvalRuns parameters: - name: session_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Session Id - name: evaluator_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Evaluator Id - name: agent_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Agent Id - name: status in: query required: false schema: anyOf: - enum: - pending - running - completed - failed - errored type: string - type: 'null' title: Status - name: scope in: query required: false schema: anyOf: - enum: - live - simulation - test type: string - type: 'null' title: Scope - name: outcome in: query required: false schema: anyOf: - enum: - passed - failed - no_verdict - errored type: string - type: 'null' title: Outcome - name: score_min in: query required: false schema: anyOf: - type: number maximum: 1 minimum: 0 - type: 'null' description: >- Min normalized score, matched against EvalScore.value [0,1]. numeric-format evaluators store their signal in raw_value (value is null), so they are not matched by score_min/score_max. title: Score Min description: >- Min normalized score, matched against EvalScore.value [0,1]. numeric-format evaluators store their signal in raw_value (value is null), so they are not matched by score_min/score_max. - name: score_max in: query required: false schema: anyOf: - type: number maximum: 1 minimum: 0 - type: 'null' description: 'Max normalized score [0,1]; see score_min re: numeric evaluators.' title: Score Max description: 'Max normalized score [0,1]; see score_min re: numeric evaluators.' - name: severity in: query required: false schema: anyOf: - type: string enum: - info - low - medium - high - critical - type: 'null' title: Severity - name: channel in: query required: false schema: anyOf: - type: string - type: 'null' title: Channel - name: created_from in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Created From - name: created_to in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Created To - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 default: 50 title: Limit - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' title: Cursor responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CursorPage_EvalRunResponse_' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: CursorPage_EvalRunResponse_: properties: items: items: $ref: '#/components/schemas/EvalRunResponse' type: array title: Items next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor has_more: type: boolean title: Has More type: object required: - items - has_more title: CursorPage[EvalRunResponse] ErrorResponse: properties: error: type: string title: Error message: type: string title: Message type: object required: - error - message title: ErrorResponse description: Standard error response returned by all API error handlers. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError EvalRunResponse: properties: id: type: string format: uuid title: Id organization_id: type: string format: uuid title: Organization Id session_id: type: string format: uuid title: Session Id evaluator_id: type: string format: uuid title: Evaluator Id agent_id: anyOf: - type: string format: uuid - type: 'null' title: Agent Id channel: anyOf: - type: string - type: 'null' title: Channel status: type: string title: Status started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At finished_at: anyOf: - type: string format: date-time - type: 'null' title: Finished At error_text: anyOf: - type: string - type: 'null' title: Error Text prompt_snapshot: anyOf: - type: string - type: 'null' title: Prompt Snapshot threshold_snapshot: anyOf: - type: number - type: 'null' title: Threshold Snapshot config_snapshot: additionalProperties: true type: object title: Config Snapshot severity_snapshot: type: string title: Severity Snapshot format_snapshot: type: string title: Format Snapshot is_critical_snapshot: type: boolean title: Is Critical Snapshot default: false created_at: type: string format: date-time title: Created At scores: items: $ref: '#/components/schemas/EvalScoreResponse' type: array title: Scores type: object required: - id - organization_id - session_id - evaluator_id - status - started_at - finished_at - error_text - prompt_snapshot - threshold_snapshot - severity_snapshot - format_snapshot - created_at title: EvalRunResponse 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 EvalScoreResponse: properties: id: type: string format: uuid title: Id organization_id: type: string format: uuid title: Organization Id eval_run_id: type: string format: uuid title: Eval Run Id value: anyOf: - type: number - type: 'null' title: Value raw_value: anyOf: - type: number - type: 'null' title: Raw Value label: anyOf: - type: string - type: 'null' title: Label passed: anyOf: - type: boolean - type: 'null' title: Passed confidence: anyOf: - type: number - type: 'null' title: Confidence rationale: anyOf: - type: string - type: 'null' title: Rationale severity: anyOf: - type: string - type: 'null' title: Severity blocking: type: boolean title: Blocking evidence_observation_ids: items: type: string type: array title: Evidence Observation Ids created_at: type: string format: date-time title: Created At type: object required: - id - organization_id - eval_run_id - value - raw_value - label - passed - confidence - rationale - severity - blocking - created_at title: EvalScoreResponse securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````