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

# Read run results

> Every dataset row of a run with what the target predicted, plus one entry per evaluator per row. Runs older than the status cache need `experimentSlug` as well, since a run id is only unique within its experiment.



## OpenAPI

````yaml GET /api/experiments/runs/{runId}/results
openapi: 3.1.0
info:
  title: LangWatch API
  version: 1.0.0
  description: LangWatch openapi spec
servers:
  - url: https://app.langwatch.ai
security:
  - project_api_key: []
paths:
  /api/experiments/runs/{runId}/results:
    get:
      tags:
        - Experiments
      summary: Read run results
      description: >-
        Every dataset row of a run with what the target predicted, plus one
        entry per evaluator per row. Runs older than the status cache need
        `experimentSlug` as well, since a run id is only unique within its
        experiment.
      operationId: getApiExperimentsRunsByRunIdResults
      parameters:
        - in: query
          name: experimentSlug
          required: false
          schema:
            type: string
          description: >-
            Owning experiment. Required once the run has aged out of the status
            cache.
        - schema:
            type: string
          in: path
          name: runId
          required: true
      responses:
        '200':
          description: Rows and evaluations for the run
          content:
            application/json:
              schema:
                type: object
                properties:
                  experimentId:
                    type: string
                  runId:
                    type: string
                  projectId:
                    type: string
                  workflowVersionId:
                    type:
                      - string
                      - 'null'
                  progress:
                    type:
                      - number
                      - 'null'
                  total:
                    type:
                      - number
                      - 'null'
                  targets:
                    type:
                      - array
                      - 'null'
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        type:
                          type: string
                        promptId:
                          type:
                            - string
                            - 'null'
                        promptVersion:
                          type:
                            - number
                            - 'null'
                        agentId:
                          type:
                            - string
                            - 'null'
                        evaluatorId:
                          type:
                            - string
                            - 'null'
                        model:
                          type:
                            - string
                            - 'null'
                        metadata:
                          type:
                            - object
                            - 'null'
                          additionalProperties:
                            anyOf:
                              - type: string
                              - type: number
                              - type: boolean
                      required:
                        - id
                        - name
                        - type
                    description: >-
                      Resolves the targetId each dataset row and evaluation
                      carries
                  dataset:
                    type: array
                    items:
                      type: object
                      properties:
                        index:
                          type: number
                        targetId:
                          type:
                            - string
                            - 'null'
                        entry:
                          type: object
                          additionalProperties: {}
                        predicted:
                          type: object
                          additionalProperties: {}
                        cost:
                          type:
                            - number
                            - 'null'
                        duration:
                          type:
                            - number
                            - 'null'
                        error:
                          type:
                            - string
                            - 'null'
                          description: >-
                            The engine's own string. Prefer domainError.code to
                            branch on
                        domainError:
                          type: object
                          properties:
                            code:
                              type: string
                              description: Stable failure code; branch on this
                            kind:
                              type: string
                              description: Deprecated alias of code, for older clients
                            message:
                              type: string
                            meta:
                              type: object
                              additionalProperties: {}
                            httpStatus:
                              type: number
                            fault:
                              type: string
                              description: >-
                                Who the failure is attributable to: customer,
                                platform, provider
                            traceId:
                              type: string
                            tips:
                              type: array
                              items:
                                type: string
                            docsUrl:
                              type: string
                          required:
                            - code
                            - kind
                          description: >-
                            Set on rows written since failures started carrying
                            codes
                        traceId:
                          type:
                            - string
                            - 'null'
                      required:
                        - index
                        - entry
                    description: One row per dataset entry, with what the target predicted
                  evaluations:
                    type: array
                    items:
                      type: object
                      properties:
                        evaluator:
                          type: string
                        name:
                          type:
                            - string
                            - 'null'
                        targetId:
                          type:
                            - string
                            - 'null'
                        status:
                          type: string
                          enum:
                            - processed
                            - skipped
                            - error
                        index:
                          type: number
                        score:
                          type:
                            - number
                            - 'null'
                        label:
                          type:
                            - string
                            - 'null'
                        passed:
                          type:
                            - boolean
                            - 'null'
                        details:
                          type:
                            - string
                            - 'null'
                        cost:
                          type:
                            - number
                            - 'null'
                        duration:
                          type:
                            - number
                            - 'null'
                        inputs:
                          type:
                            - object
                            - 'null'
                          additionalProperties: {}
                      required:
                        - evaluator
                        - status
                        - index
                    description: One row per evaluator per dataset entry
                  timestamps:
                    type: object
                    properties:
                      createdAt:
                        type: number
                      updatedAt:
                        type: number
                      finishedAt:
                        type:
                          - number
                          - 'null'
                      stoppedAt:
                        type:
                          - number
                          - 'null'
                    required:
                      - createdAt
                      - updatedAt
                required:
                  - experimentId
                  - runId
                  - projectId
                  - dataset
                  - evaluations
                  - timestamps
        '401':
          description: Missing or invalid API key, or the key lacks the permission
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Stable failure code; branch on this
                  message:
                    type: string
                  fault:
                    type: string
                    description: >-
                      Who the failure is attributable to: customer, platform,
                      provider
                  tips:
                    type: array
                    items:
                      type: string
                  docsUrl:
                    type: string
                required:
                  - error
                additionalProperties: true
        '404':
          description: No such experiment or run in this project
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Stable failure code; branch on this
                  message:
                    type: string
                  fault:
                    type: string
                    description: >-
                      Who the failure is attributable to: customer, platform,
                      provider
                  tips:
                    type: array
                    items:
                      type: string
                  docsUrl:
                    type: string
                required:
                  - error
                additionalProperties: true
components:
  securitySchemes:
    project_api_key:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: >-
        Project API key for sending traces and accessing project-scoped
        resources. Format: sk-lw-... (no underscore). Obtain one by creating a
        project via the Admin API or the LangWatch UI.

````