> ## Documentation Index > Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt > Use this file to discover all available pages before exploring further. # List evaluation results > Cursor-paginated results for one evaluation across every agent it grades, newest first. Each session appears once with its latest result; queued and in-progress results are included so a run can be followed to completion. ## OpenAPI ````yaml get /evaluations/{evaluation_id}/results openapi: 3.0.0 info: title: Public API version: 1.0.0 servers: - url: https://api.gumloop.com/api/v1 security: [] paths: /evaluations/{evaluation_id}/results: get: tags: - Organization Evaluations summary: List evaluation results description: >- Cursor-paginated results for one evaluation across every agent it grades, newest first. Each session appears once with its latest result; queued and in-progress results are included so a run can be followed to completion. operationId: listOrganizationEvaluationResults parameters: - in: path name: evaluation_id required: true schema: type: string description: ID of the organization evaluation. - in: query name: agent_id required: false schema: type: string description: Only results for this agent. - in: query name: session_id required: false schema: type: string description: Only results for this session. - in: query name: grade required: false schema: type: string enum: - pass - needs_review - needs_attention description: Filter by grade. - in: query name: status required: false schema: type: string enum: - queued - in_progress - completed - failed description: Filter by status. - in: query name: created_after required: false schema: type: string format: date-time description: >- Only results created at or after this time. RFC 3339 with an explicit offset (for example `2026-09-01T00:00:00Z`). - in: query name: created_before required: false schema: type: string format: date-time description: >- Only results created before this time. RFC 3339 with an explicit offset. - in: query name: page_size required: false schema: type: integer minimum: 1 maximum: 100 default: 20 description: Items per page (1-100). - in: query name: cursor required: false schema: type: string description: Pagination cursor from a previous response's `next_cursor`. responses: '200': description: Paginated results. content: application/json: schema: $ref: '#/components/schemas/EvaluationResultList' '400': description: Invalid filter value. '401': description: Unauthorized — missing or invalid credentials. '403': description: >- Forbidden — not an organization admin, or the organization is not on the Enterprise plan. '404': description: Evaluation not found. security: - bearerAuth: [] x-codeSamples: - lang: bash label: cURL source: > curl 'https://api.gumloop.com/api/v1/evaluations/EVALUATION_ID/results?grade=needs_attention' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' - lang: python label: Python source: > from gumloop import Gumloop client = Gumloop(access_token="YOUR_ACCESS_TOKEN") response = client.evaluations.list_results("EVALUATION_ID", grade="needs_attention") for result in response.results: print(result.agent_id, result.session_id, result.summary) components: schemas: EvaluationResultList: type: object properties: results: type: array items: $ref: '#/components/schemas/EvaluationResultRecord' next_cursor: type: string nullable: true description: >- Pass as `cursor` to fetch the next page. Null when there are no more results. EvaluationResultRecord: type: object properties: id: type: string description: Result ID. evaluation_id: type: string nullable: true description: >- The organization evaluation that produced this result. Null when the agent's own evaluation did. session_id: type: string agent_id: type: string status: type: string enum: - queued - in_progress - completed - failed grade: type: string nullable: true enum: - pass - needs_review - needs_attention description: Set once `status` is `completed`. error_code: type: string nullable: true description: >- Set when `status` is `failed`, for example `evaluation_model_error`, `evaluation_dispatch_error`, or `skipped_not_terminal_state`. model_name: type: string nullable: true call_successful: type: string nullable: true enum: - success - failure - unknown sentiment: type: string nullable: true enum: - positive - neutral - negative summary: type: string nullable: true criteria_results: type: array items: type: object additionalProperties: true data_results: type: array items: type: object additionalProperties: true applied_tags: type: array items: type: string created_at: type: string format: date-time example: id: 9f2d6a41-3b7c-4e0a-8f11-2c5d7e9b0a3f evaluation_id: 1c1b3c8e-7d61-4c1e-9c66-4a8d2f1e0b7a session_id: int_xyz789 agent_id: agent_456 status: completed grade: pass error_code: null model_name: auto call_successful: success sentiment: positive summary: >- Customer asked about a refund window; the agent answered accurately and politely. criteria_results: - id: crit_1 name: Greets the customer result: success rationale: The agent opened with the customer's name. data_results: [] applied_tags: - REFUND_REQUEST created_at: '2026-09-03T21:40:00+00:00' securitySchemes: bearerAuth: type: http scheme: bearer description: >- A personal API key or an [OAuth 2.0](/api-reference/oauth) access token. Personal API keys also require the `x-auth-key` header with your user ID. ````