> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genai.scale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve evaluation results

> Fetches the results of a completed or in-progress evaluation job. Accuracy, histogram, and errored response count values are only available for completed jobs.



## OpenAPI

````yaml GET /v2/autoevals/{jobId}/results
openapi: 3.1.0
info:
  title: GenAI API Spec
  description: 'Data Engine: Generative AI API Specification'
  version: 0.0.1
servers:
  - url: https://api.scale.com
security:
  - bearerAuth: []
  - basicAuth: []
paths:
  /v2/autoevals/{jobId}/results:
    get:
      summary: Retrieve evaluation results
      description: >-
        Fetches the results of a completed or in-progress evaluation job.
        Accuracy, histogram, and errored response count values are only
        available for completed jobs.
      parameters:
        - in: path
          name: jobId
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved evaluation results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  overallAccuracy:
                    type: number
                    nullable: true
                    description: >-
                      Computed as passes / (passes + failures), ignoring errored
                      responses.
                  histogram:
                    type: array
                    nullable: true
                    items:
                      type: object
                      properties:
                        passes:
                          type: integer
                        failures:
                          type: integer
                        count:
                          type: integer
                  promptResponsePairs:
                    type: integer
                  passedResponses:
                    type: integer
                  failedResponses:
                    type: integer
                  erroredResponses:
                    type: integer
                    nullable: true
              examples:
                CustomResults:
                  value:
                    overallAccuracy: 0.8
                    histogram:
                      - passes: 1
                        failures: 4
                        count: 9
                      - passes: 2
                        failures: 6
                        count: 10
                    promptResponsePairs: 19
                    passedResponses: 10
                    failedResponses: 8
                    erroredResponses: 1
        '404':
          description: Results not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status_code:
                    type: number
                    example: 404
                  error:
                    type: string
                    example: Results not found.
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status_code:
                    type: number
                    example: 500
                  error:
                    type: string
                    example: An error has occurred.
components:
  securitySchemes:
    bearerAuth:
      description: >-
        Your API Key is the Bearer token. See the
        [Authentication](/get-started/authentication) section to learn how to
        access your key.
      type: http
      scheme: bearer
    basicAuth:
      description: >-
        Basic HTTP Authentication. Your API Key is your username.  Learn more
        about setting up Authentication [here](/get-started/authentication).
      type: http
      scheme: basic

````