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

# List runs of an experiment

> Runs recorded for one experiment, newest first. Page through them with `page` and `pageSize`.



## OpenAPI

````yaml GET /api/experiments/runs
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:
    get:
      tags:
        - Experiments
      summary: List runs of an experiment
      description: >-
        Runs recorded for one experiment, newest first. Page through them with
        `page` and `pageSize`.
      operationId: getApiExperimentsRuns
      parameters:
        - in: query
          name: experimentSlug
          required: true
          schema:
            type: string
          description: Slug of the experiment whose runs you want
        - in: query
          name: page
          required: false
          schema:
            type: integer
            default: 1
          description: 1-based page number
        - in: query
          name: pageSize
          required: false
          schema:
            type: integer
            default: 50
            maximum: 200
          description: Runs per page, capped at 200
      responses:
        '200':
          description: Runs for the experiment
          content:
            application/json:
              schema:
                type: object
                properties:
                  experimentId:
                    type: string
                  experimentSlug:
                    type: string
                  runs:
                    type: array
                    items:
                      type: object
                      properties:
                        experimentId:
                          type: string
                        runId:
                          type: string
                        workflowVersion:
                          type:
                            - object
                            - 'null'
                          properties:
                            id:
                              type: string
                            version:
                              type: string
                            commitMessage:
                              type: string
                            author:
                              type:
                                - object
                                - 'null'
                              properties:
                                name:
                                  type:
                                    - string
                                    - 'null'
                                image:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - name
                                - image
                          required:
                            - id
                            - version
                            - commitMessage
                            - author
                        timestamps:
                          type: object
                          properties:
                            createdAt:
                              type: number
                            updatedAt:
                              type: number
                            finishedAt:
                              type:
                                - number
                                - 'null'
                            stoppedAt:
                              type:
                                - number
                                - 'null'
                          required:
                            - createdAt
                            - updatedAt
                        progress:
                          type:
                            - number
                            - 'null'
                        total:
                          type:
                            - number
                            - 'null'
                        summary:
                          type: object
                          properties:
                            datasetCost:
                              type: number
                            evaluationsCost:
                              type: number
                            datasetAverageCost:
                              type: number
                            datasetAverageDuration:
                              type: number
                            evaluationsAverageCost:
                              type: number
                            evaluationsAverageDuration:
                              type: number
                            evaluations:
                              type: object
                              additionalProperties:
                                type: object
                                properties:
                                  name:
                                    type: string
                                  averageScore:
                                    type:
                                      - number
                                      - 'null'
                                  averagePassed:
                                    type: number
                                required:
                                  - name
                                  - averageScore
                          required:
                            - evaluations
                      required:
                        - experimentId
                        - runId
                        - workflowVersion
                        - timestamps
                        - summary
                  pagination:
                    type: object
                    properties:
                      page:
                        type: number
                      pageSize:
                        type: number
                      totalHits:
                        type: number
                      hasMore:
                        type: boolean
                    required:
                      - page
                      - pageSize
                      - totalHits
                      - hasMore
                required:
                  - experimentId
                  - experimentSlug
                  - runs
                  - pagination
        '400':
          description: experimentSlug was not supplied
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '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.

````