> ## Documentation Index > Fetch the complete documentation index at: https://docs.coval.ai/llms.txt > Use this file to discover all available pages before exploring further. # List report rows > List a report's per-simulation rows, each with its metric outputs inline. Cursor-paginated. Optionally narrow with `metric_ids` and `simulation_output_ids` (comma-separated). ## OpenAPI ````yaml /api-reference/v1/reports-v1.yaml get /reports/{report_id}/rows openapi: 3.0.3 info: title: Coval Reports API version: 1.0.0 description: | Create and manage saved multi-run reports from existing simulation runs. contact: name: Coval API Support email: support@coval.dev url: https://docs.coval.dev license: name: Proprietary url: https://coval.dev/terms servers: - url: https://api.coval.dev/v1 description: Production API security: - ApiKeyAuth: [] tags: - name: Reports description: CRUD operations for saved multi-run reports paths: /reports/{report_id}/rows: get: tags: - Reports summary: List report rows description: > List a report's per-simulation rows, each with its metric outputs inline. Cursor-paginated. Optionally narrow with `metric_ids` and `simulation_output_ids` (comma-separated). operationId: listReportRows parameters: - $ref: '#/components/parameters/ReportId' - name: cursor in: query required: false schema: type: string description: Pagination cursor from a prior response's next_page_token. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 2000 default: 2000 description: Max rows per page (1-2000). - name: metric_ids in: query required: false schema: type: string description: Comma-separated metric ids to include. - name: simulation_output_ids in: query required: false schema: type: string description: Comma-separated simulation output ids to restrict to. responses: '200': description: A page of report rows content: application/json: schema: $ref: '#/components/schemas/ListReportRowsResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/ServiceUnavailable' security: - ApiKeyAuth: [] components: parameters: ReportId: name: report_id in: path required: true schema: type: string minLength: 26 maxLength: 26 description: Saved report ULID. example: 01JABCDEFGHJKMNPQRSTVWXYZ0 schemas: ListReportRowsResponse: type: object required: - rows properties: rows: type: array items: $ref: '#/components/schemas/ReportRowResource' next_page_token: type: string nullable: true description: Cursor for the next page; null when there are no more rows. ReportRowResource: type: object required: - simulation_id - run_id properties: simulation_id: type: string run_id: type: string test_set_id: type: string nullable: true persona_id: type: string nullable: true agent_id: type: string nullable: true status: type: string nullable: true create_time: type: string format: date-time nullable: true start_time: type: string format: date-time nullable: true end_time: type: string format: date-time nullable: true error_message: type: string nullable: true notes: type: string nullable: true is_public: type: boolean mutation_id: type: string nullable: true mutation_name: type: string nullable: true model_type: type: string nullable: true tags: type: array items: type: string metadata: type: object additionalProperties: true nullable: true metrics: type: array items: $ref: '#/components/schemas/ReportMetricOutput' ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/Error' ReportMetricOutput: type: object properties: metric_id: type: string nullable: true metric_output_id: type: string nullable: true description: Metric output id (26-char ULID). output_type: type: string nullable: true value: nullable: true description: Metric value (float, string, or list of strings). anyOf: - type: number - type: string - type: array items: type: string status: type: string nullable: true Error: type: object required: - code - message properties: code: type: string enum: - INVALID_ARGUMENT - UNAUTHENTICATED - PERMISSION_DENIED - NOT_FOUND - INTERNAL description: Machine-readable error code. example: INVALID_ARGUMENT message: type: string description: Human-readable error message. example: Invalid request body details: type: array maxItems: 100 items: $ref: '#/components/schemas/ErrorDetail' ErrorDetail: type: object properties: field: type: string nullable: true description: Field that caused the error, when available. example: metadata_key description: type: string description: Human-readable detail about the error. example: metadata_key is required when compare_by is metadata responses: BadRequest: description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: INVALID_ARGUMENT message: Invalid request body details: - field: metadata_key description: metadata_key is required when compare_by is metadata Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: UNAUTHENTICATED message: Authentication failed details: - field: x-api-key description: API key is required in the x-api-key header Forbidden: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: PERMISSION_DENIED message: Insufficient permissions details: - field: permissions description: The API key does not include the required report permission. InternalError: description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: INTERNAL message: Internal server error details: - description: >- An unexpected error occurred while processing the report request ServiceUnavailable: description: Service temporarily unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: INTERNAL message: Service temporarily unavailable details: - description: Database routing is temporarily unavailable. Please retry. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key for authentication ````