> ## Documentation Index > Fetch the complete documentation index at: https://www.adaline.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Evaluations > List all evaluation runs for a prompt. Paginated. ## OpenAPI ````yaml GET /prompts/{promptId}/evaluations openapi: 3.1.1 info: title: Adaline API version: 2.0.0 description: >- Public API for managing Adaline projects, prompts, datasets, evaluators, evaluations, providers, models, and deployments. Generated from Zod schemas — this spec is the single source of truth. servers: - url: https://api.adaline.ai/v2 description: Production API security: [] tags: - name: datasets description: Manage prompt datasets and their columns and rows. - name: projects description: List and manage Adaline projects. - name: providers description: List configured LLM providers and their settings. - name: models description: List available models across providers. - name: prompts description: Create and manage prompts and their drafts. - name: evaluators description: Configure evaluators attached to a prompt. - name: evaluations description: Run and inspect evaluation results. - name: deployments description: Retrieve deployed prompt snapshots. - name: logs description: Ingest execution traces and spans for observability. paths: /prompts/{promptId}/evaluations: get: tags: - evaluations summary: List evaluations description: List all evaluation runs for a prompt. Paginated. operationId: listEvaluations parameters: - schema: $ref: '#/components/schemas/BaseEntityId' required: true name: promptId in: path - schema: $ref: '#/components/schemas/EvaluationStatus' required: false name: status in: query - schema: $ref: '#/components/schemas/BaseEntityId' required: false name: evaluatorId in: query - schema: $ref: '#/components/schemas/BaseEntityId' required: false name: datasetId in: query - schema: $ref: '#/components/schemas/SortOrder' required: false name: sort in: query - schema: type: - integer - 'null' minimum: 0 required: false name: createdAfter in: query - schema: type: - integer - 'null' minimum: 0 required: false name: createdBefore in: query - schema: type: integer exclusiveMinimum: 0 maximum: 200 required: false name: limit in: query - schema: type: string minLength: 1 required: false name: cursor in: query responses: '200': description: Evaluations retrieved. content: application/json: schema: $ref: '#/components/schemas/ListEvaluationsResponse' headers: X-Request-Id: description: >- Unique identifier for the request. Returned in every response. Send a custom value to correlate requests, or omit to receive a generated UUID. schema: type: string format: uuid '400': description: Bad request — validation error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized — invalid or missing API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden — API key lacks access. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: BaseEntityId: title: Base Entity ID type: string description: Unique identifier for an entity, between 20 and 80 characters. minLength: 20 maxLength: 80 EvaluationStatus: title: Evaluation Status type: string enum: - queued - running - completed - failed - cancelled - cancelling description: The current status of an evaluation run. SortOrder: title: Sort Order type: string enum: - createdAt:asc - createdAt:desc description: Sort order for list endpoints. ListEvaluationsResponse: type: object properties: evaluations: type: array items: $ref: '#/components/schemas/Evaluation' pagination: $ref: '#/components/schemas/Pagination' required: - evaluations - pagination title: List Evaluations Response description: Paginated list of evaluations. ErrorResponse: title: Error Response type: object description: >- Standard error response envelope. Permits backend-specific sibling fields (e.g. Zod issue details) alongside the typed `error`. properties: error: description: >- Error details — typed envelope, or a raw string reason when the backend's validator produces a short summary (e.g. Zod validation fallback). oneOf: - type: string - type: object properties: code: type: string description: Machine-readable error code. enum: - VALIDATION_ERROR - INVALID_CURSOR - AUTHENTICATION_REQUIRED - FORBIDDEN - RESOURCE_NOT_FOUND - CONFLICT - PAYLOAD_TOO_LARGE - RATE_LIMITED - INTERNAL_ERROR message: type: string description: Human-readable error message. details: type: array description: Optional field-level validation details. items: type: object properties: field: type: string issue: type: string required: - field - issue required: - code - message additionalProperties: true required: - error additionalProperties: true Evaluation: title: Evaluation type: object description: An evaluation run with its status, progress, metrics, and timeline. properties: runId: $ref: '#/components/schemas/BaseEntityId' evaluatorId: $ref: '#/components/schemas/BaseEntityId' datasetId: $ref: '#/components/schemas/BaseEntityId' status: $ref: '#/components/schemas/EvaluationStatus' progress: $ref: '#/components/schemas/EvaluationProgress' metrics: $ref: '#/components/schemas/EvaluationMetrics' timeline: $ref: '#/components/schemas/EvaluationRunTimeline' required: - runId - evaluatorId - status - progress - metrics - timeline Pagination: title: Pagination type: object description: Pagination metadata for list endpoints with cursor-based navigation. properties: limit: type: integer exclusiveMinimum: 0 returned: type: integer minimum: 0 hasMore: type: boolean nextCursor: type: - string - 'null' required: - limit - returned - hasMore - nextCursor EvaluationProgress: title: Evaluation Progress type: object description: Progress information for an evaluation run. properties: totalRows: type: integer completedRows: type: integer failedRows: type: integer percent: type: integer minimum: 0 maximum: 100 required: - totalRows - completedRows - failedRows - percent EvaluationMetrics: title: Evaluation Metrics type: object description: Aggregated metrics for an evaluation run. properties: passRuns: type: integer failRuns: type: integer unknownRuns: type: integer totalCost: type: number totalLatency: type: number totalTokenCount: type: number required: - passRuns - failRuns - unknownRuns - totalCost - totalLatency - totalTokenCount EvaluationRunTimeline: title: Evaluation Run Timeline type: object description: Timestamp information for an evaluation run. properties: submittedAt: $ref: '#/components/schemas/UnixTimestamp' startedAt: type: - integer - 'null' description: >- Unix timestamp in seconds when the evaluation started, or null if not yet started. finishedAt: type: - integer - 'null' description: >- Unix timestamp in seconds when the evaluation finished, or null if not yet finished. required: - submittedAt - startedAt - finishedAt UnixTimestamp: title: Unix Timestamp type: integer format: int64 description: Unix timestamp in milliseconds. minimum: 1672511400000 maximum: 33229420200000 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: 'Workspace API key. Pass as `Authorization: Bearer `.' ````