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

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.

# Get a dataset version

> Read one version of a dataset: its metadata and a page of the rows it held. A version the dataset does not have is refused with `dataset_version_not_found`.



## OpenAPI

````yaml GET /api/v1/dataset/{slugOrId}/versions/{version}
openapi: 3.1.0
info:
  title: LangWatch API
  description: LangWatch openapi spec
  version: 1.0.0
servers:
  - url: https://app.langwatch.ai
security:
  - project_api_key: []
paths:
  /api/v1/dataset/{slugOrId}/versions/{version}:
    get:
      summary: Get a dataset version
      description: >-
        Read one version of a dataset: its metadata and a page of the rows it
        held. A version the dataset does not have is refused with
        `dataset_version_not_found`.
      operationId: getApiDatasetBySlugOrIdVersionsByVersion
      parameters:
        - in: path
          name: slugOrId
          schema:
            type: string
          required: true
        - in: path
          name: version
          schema:
            type: integer
            exclusiveMinimum: 0
            maximum: 9007199254740991
          required: true
        - in: query
          name: page
          schema:
            default: 1
            type: integer
            exclusiveMinimum: 0
            maximum: 9007199254740991
        - in: query
          name: limit
          schema:
            default: 50
            type: integer
            exclusiveMinimum: 0
            maximum: 500
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  version:
                    type: object
                    properties:
                      id:
                        type: string
                        minLength: 1
                      projectId:
                        type: string
                        minLength: 1
                      datasetId:
                        type: string
                        minLength: 1
                      version:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      name:
                        type:
                          - string
                          - 'null'
                      trigger:
                        type: string
                        enum:
                          - autosave
                          - manual
                          - experiment_run
                          - restore
                          - initial
                      contentHash:
                        type: string
                        minLength: 1
                      columnTypes:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                              minLength: 1
                            type:
                              type: string
                              enum:
                                - string
                                - boolean
                                - number
                                - date
                                - list
                                - json
                                - spans
                                - rag_contexts
                                - chat_messages
                                - annotations
                                - evaluations
                                - image
                                - file
                          required:
                            - name
                            - type
                          additionalProperties: false
                      rowCount:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      sizeBytes:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      chunkCount:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      restoredFromVersion:
                        anyOf:
                          - type: integer
                            exclusiveMinimum: 0
                            maximum: 9007199254740991
                          - type: 'null'
                      authorId:
                        type:
                          - string
                          - 'null'
                      authorKind:
                        anyOf:
                          - type: string
                            enum:
                              - user
                              - api_key
                              - system
                          - type: 'null'
                      pinned:
                        type: boolean
                      runCount:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      createdAt:
                        type: string
                        format: date-time
                    required:
                      - id
                      - projectId
                      - datasetId
                      - version
                      - name
                      - trigger
                      - contentHash
                      - columnTypes
                      - rowCount
                      - sizeBytes
                      - chunkCount
                      - restoredFromVersion
                      - authorId
                      - authorKind
                      - pinned
                      - runCount
                      - createdAt
                    additionalProperties: false
                  rows:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          minLength: 1
                        entry:
                          type: object
                          propertyNames:
                            type: string
                          additionalProperties: {}
                      required:
                        - id
                        - entry
                      additionalProperties: false
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      limit:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      total:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                    required:
                      - page
                      - limit
                      - total
                    additionalProperties: false
                required:
                  - version
                  - rows
                  - pagination
                additionalProperties: false
        '404':
          description: The dataset has no version with that number.
          content: {}
      security:
        - project_api_key: []
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.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.