> ## 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.

# Retrieve evaluation result

> One result, including per-criterion outcomes, extracted data points, and applied tags. Poll this after `POST /evaluations/{evaluation_id}/run` until `status` is `completed` or `failed`.



## OpenAPI

````yaml get /evaluations/{evaluation_id}/results/{result_id}
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/{result_id}:
    get:
      tags:
        - Organization Evaluations
      summary: Retrieve evaluation result
      description: >-
        One result, including per-criterion outcomes, extracted data points, and
        applied tags. Poll this after `POST /evaluations/{evaluation_id}/run`
        until `status` is `completed` or `failed`.
      operationId: getOrganizationEvaluationResult
      parameters:
        - in: path
          name: evaluation_id
          required: true
          schema:
            type: string
          description: ID of the organization evaluation.
        - in: path
          name: result_id
          required: true
          schema:
            type: string
          description: Result ID from a run response or a results list.
      responses:
        '200':
          description: The result.
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/EvaluationResultRecord'
        '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 or result not found (`result_not_found`).
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >
            curl
            'https://api.gumloop.com/api/v1/evaluations/EVALUATION_ID/results/RESULT_ID'
            \
              -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
        - lang: python
          label: Python
          source: >
            from gumloop import Gumloop


            client = Gumloop(access_token="YOUR_ACCESS_TOKEN")


            result = client.evaluations.get_result("EVALUATION_ID",
            "RESULT_ID").result

            print(result.status, result.grade, result.error_code)
components:
  schemas:
    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.

````