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

# Get an eval run



## OpenAPI

````yaml /openapi.json post /v1/evals.get
openapi: 3.1.0
info:
  title: Anpord API
  version: 1.0.0
  description: >-
    Run agent evals and manage prompts. Every endpoint takes a JSON body over
    POST and authenticates with a bearer API key.
servers:
  - description: Production
    url: https://api.anpord.com
security: []
tags:
  - name: Evals
    description: >-
      Run cases across harness, model, and sandbox combinations and compare the
      results with their baselines.
  - name: Prompts
    description: >-
      Read and write prompts. Content is versioned, so writes append rather than
      overwrite, and channels decide which version callers receive.
paths:
  /v1/evals.get:
    post:
      tags:
        - Evals
      summary: Get an eval run
      operationId: evals.get
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EvalRunRequest'
        required: true
      responses:
        '200':
          description: A complete eval run with its cells and trials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvalRun'
        '400':
          description: The request did not match the expected schema
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/HttpApiDecodeError'
                  - $ref: '#/components/schemas/BadRequest'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unauthorized'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden'
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conflict'
      security:
        - bearer: []
components:
  schemas:
    EvalRunRequest:
      type: object
      required:
        - id
      properties:
        id:
          type: string
      additionalProperties: false
      description: Select an eval run by id.
    EvalRun:
      type: object
      required:
        - cases
        - cells
        - failure
        - finishedAt
        - id
        - startedAt
        - status
        - tasks
      properties:
        cases:
          type: array
          items:
            type: string
        cells:
          type: array
          items:
            $ref: '#/components/schemas/EvalCell'
        failure:
          anyOf:
            - type: string
            - type: 'null'
        finishedAt:
          anyOf:
            - $ref: '#/components/schemas/EvalTimestamp'
            - type: 'null'
        id:
          type: string
        startedAt:
          $ref: '#/components/schemas/EvalTimestamp'
        status:
          type: string
          enum:
            - running
            - finished
            - failed
        tasks:
          type: array
          items:
            $ref: '#/components/schemas/EvalTask'
      additionalProperties: false
      description: A complete eval run with its cells and trials.
    HttpApiDecodeError:
      type: object
      required:
        - issues
        - message
        - _tag
      properties:
        issues:
          type: array
          items:
            $ref: '#/components/schemas/Issue'
        message:
          type: string
        _tag:
          type: string
          enum:
            - HttpApiDecodeError
      additionalProperties: false
      description: The request did not match the expected schema
    BadRequest:
      type: object
      required:
        - message
        - _tag
      properties:
        message:
          type: string
        _tag:
          type: string
          enum:
            - BadRequest
      additionalProperties: false
    Unauthorized:
      type: object
      required:
        - message
        - _tag
      properties:
        message:
          type: string
        _tag:
          type: string
          enum:
            - Unauthorized
      additionalProperties: false
    Forbidden:
      type: object
      required:
        - message
        - _tag
      properties:
        message:
          type: string
        _tag:
          type: string
          enum:
            - Forbidden
      additionalProperties: false
    NotFound:
      type: object
      required:
        - message
        - _tag
      properties:
        message:
          type: string
        _tag:
          type: string
          enum:
            - NotFound
      additionalProperties: false
    Conflict:
      type: object
      required:
        - message
        - _tag
      properties:
        message:
          type: string
        _tag:
          type: string
          enum:
            - Conflict
      additionalProperties: false
    EvalCell:
      type: object
      required:
        - caseName
        - cellKey
        - comparison
        - distribution
        - internalId
        - setup
        - status
        - taskIndex
        - trials
      properties:
        caseName:
          type: string
        cellKey:
          anyOf:
            - type: string
            - type: 'null'
        comparison:
          anyOf:
            - $ref: '#/components/schemas/EvalComparison'
            - type: 'null'
        distribution:
          anyOf:
            - $ref: '#/components/schemas/EvalDistribution'
            - type: 'null'
        internalId:
          anyOf:
            - type: string
            - type: 'null'
        setup:
          anyOf:
            - $ref: '#/components/schemas/EvalSetup'
            - type: 'null'
        status:
          type: string
          enum:
            - running
            - finished
            - failed
        taskIndex:
          $ref: '#/components/schemas/Int'
        trials:
          type: array
          items:
            $ref: '#/components/schemas/EvalTrial'
      additionalProperties: false
      description: One case and task combination in an eval grid.
    EvalTimestamp:
      type: string
      description: An ISO-8601 timestamp in UTC.
      format: date-time
    EvalTask:
      type: object
      required:
        - harness
        - harnessVersion
        - model
        - provider
      properties:
        harness:
          type: string
          enum:
            - codex
            - opencode
            - pi
            - fx
            - claude
            - gemini
            - qwen
            - cursor
        harnessVersion:
          type: string
        model:
          type: string
        provider:
          type: string
          enum:
            - daytona
            - e2b
            - upstash
            - modal
            - cloudflare
            - vercel
            - local
      additionalProperties: false
      description: The harness, installed version, model, and sandbox for a cell.
    Issue:
      type: object
      required:
        - _tag
        - path
        - message
      properties:
        _tag:
          type: string
          enum:
            - Pointer
            - Unexpected
            - Missing
            - Composite
            - Refinement
            - Transformation
            - Type
            - Forbidden
          description: The tag identifying the type of parse issue
        path:
          type: array
          items:
            $ref: '#/components/schemas/PropertyKey'
          description: The path to the property where the issue occurred
        message:
          type: string
          description: A descriptive message explaining the issue
      additionalProperties: false
      description: >-
        Represents an error encountered while parsing a value to match the
        schema
    EvalComparison:
      type: object
      required:
        - baselinePassRate
        - candidatePassRate
        - delta
        - determinismLost
        - reason
        - verdict
      properties:
        baselinePassRate:
          type: number
        candidatePassRate:
          type: number
        delta:
          type: number
        determinismLost:
          type: boolean
        reason:
          anyOf:
            - type: string
            - type: 'null'
        verdict:
          type: string
          enum:
            - improved
            - incomparable
            - regressed
            - unchanged
      additionalProperties: false
      description: The cell result compared with its most recent baseline.
    EvalDistribution:
      type: object
      required:
        - commandMax
        - commandMedian
        - commandMin
        - deterministic
        - failed
        - passRate
        - passed
        - scored
        - trials
        - voided
      properties:
        commandMax:
          $ref: '#/components/schemas/Int'
        commandMedian:
          type: number
        commandMin:
          $ref: '#/components/schemas/Int'
        deterministic:
          type: boolean
        failed:
          $ref: '#/components/schemas/Int'
        passRate:
          type: number
        passed:
          $ref: '#/components/schemas/Int'
        scored:
          $ref: '#/components/schemas/Int'
        trials:
          $ref: '#/components/schemas/Int'
        voided:
          $ref: '#/components/schemas/Int'
      additionalProperties: false
      description: The scored outcome across all trials in a cell.
    EvalSetup:
      type: object
      required:
        - prompt
        - repoRef
        - repoUrl
        - setupCommand
        - verifyCommand
        - workspace
      properties:
        prompt:
          type: string
        repoRef:
          anyOf:
            - type: string
            - type: 'null'
        repoUrl:
          anyOf:
            - type: string
            - type: 'null'
        setupCommand:
          anyOf:
            - type: string
            - type: 'null'
        verifyCommand:
          anyOf:
            - type: string
            - type: 'null'
        workspace:
          type: string
      additionalProperties: false
      description: The prompt, workspace, setup, and verifier used by a cell.
    Int:
      type: integer
      description: an integer
      title: int
    EvalTrial:
      type: object
      required:
        - commands
        - exitCode
        - failedCommands
        - filesChanged
        - modelMs
        - ordinal
        - passed
        - sandboxId
        - sandboxMs
        - status
        - timed
        - trajectory
        - usage
        - voidFields
      properties:
        commands:
          $ref: '#/components/schemas/Int'
        exitCode:
          $ref: '#/components/schemas/Int'
        failedCommands:
          $ref: '#/components/schemas/Int'
        filesChanged:
          type: array
          items:
            type: string
        modelMs:
          $ref: '#/components/schemas/Int'
        ordinal:
          $ref: '#/components/schemas/Int'
        passed:
          type: boolean
        sandboxId:
          anyOf:
            - type: string
            - type: 'null'
        sandboxMs:
          $ref: '#/components/schemas/Int'
        status:
          type: string
          enum:
            - queued
            - running
            - passed
            - failed
            - void
            - exceeded
        timed:
          type: boolean
        trajectory:
          type: array
          items:
            $ref: '#/components/schemas/EvalJournalEntry'
        usage:
          anyOf:
            - $ref: '#/components/schemas/EvalUsage'
            - type: 'null'
        voidFields:
          type: array
          items:
            type: string
      additionalProperties: false
      description: One sandbox attempt for a grid cell.
    PropertyKey:
      anyOf:
        - type: string
        - type: number
        - type: object
          required:
            - _tag
            - key
          properties:
            _tag:
              type: string
              enum:
                - symbol
            key:
              type: string
          additionalProperties: false
          description: an object to be decoded into a globally shared symbol
    EvalJournalEntry:
      anyOf:
        - type: object
          required:
            - _tag
            - command
            - exitCode
            - finishedAtMillis
            - output
            - startedAtMillis
          properties:
            _tag:
              type: string
              enum:
                - command
            command:
              type: string
            exitCode:
              anyOf:
                - $ref: '#/components/schemas/Int'
                - type: 'null'
            finishedAtMillis:
              anyOf:
                - type: number
                - type: 'null'
            output:
              type: string
            startedAtMillis:
              anyOf:
                - type: number
                - type: 'null'
          additionalProperties: false
        - type: object
          required:
            - _tag
            - finishedAtMillis
            - text
          properties:
            _tag:
              type: string
              enum:
                - message
            finishedAtMillis:
              anyOf:
                - type: number
                - type: 'null'
            text:
              type: string
          additionalProperties: false
        - type: object
          required:
            - _tag
            - finishedAtMillis
            - name
            - status
          properties:
            _tag:
              type: string
              enum:
                - toolCall
            finishedAtMillis:
              anyOf:
                - type: number
                - type: 'null'
            name:
              type: string
            status:
              anyOf:
                - type: string
                - type: 'null'
          additionalProperties: false
        - type: object
          required:
            - _tag
            - finishedAtMillis
            - paths
          properties:
            _tag:
              type: string
              enum:
                - fileChange
            finishedAtMillis:
              anyOf:
                - type: number
                - type: 'null'
            paths:
              type: array
              items:
                type: string
          additionalProperties: false
      description: A normalized event recorded from the harness trajectory.
    EvalUsage:
      type: object
      required:
        - inputTokens
        - outputTokens
        - totalTokens
      properties:
        inputTokens:
          $ref: '#/components/schemas/Int'
        outputTokens:
          $ref: '#/components/schemas/Int'
        totalTokens:
          $ref: '#/components/schemas/Int'
      additionalProperties: false
      description: Token usage reported by the harness.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````