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

# List Model Versions

> List all versions of a model.



## OpenAPI

````yaml /openapi.json get /models/{model_id}/versions
openapi: 3.1.0
info:
  title: Woodwide API
  description: API service for the Woodwide platform
  version: 0.1.0
servers:
  - url: https://api.woodwide.ai
    description: Production
security: []
paths:
  /models/{model_id}/versions:
    get:
      tags:
        - Models
      summary: List Model Versions
      description: List all versions of a model.
      operationId: list_model_versions_models__model_id__versions_get
      parameters:
        - name: model_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Model Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListModelVersionsResponse'
              example:
                items:
                  - model_version_id: b2c3d4e5-0000-0000-0000-000000000002
                    model_id: b2c3d4e5-0000-0000-0000-000000000001
                    version: 1
                    status: ready
                    created_at: '2025-01-15T11:00:00Z'
        '401':
          description: Unauthorized -- API key is missing or invalid.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Not authenticated
        '403':
          description: >-
            Forbidden -- your API key does not have permission for this
            resource.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Forbidden
        '404':
          description: Not Found -- the requested resource does not exist.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: >-
            Too Many Requests -- you have exceeded the rate limit. Heavy
            operations (training, inference, dataset uploads) are limited to 60
            requests per minute per API key. All other endpoints are limited to
            600 requests per minute per API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Rate limit exceeded. Retry after a short delay.
      security:
        - HTTPBearer: []
components:
  schemas:
    ListModelVersionsResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/ModelVersion'
          type: array
          title: Items
      type: object
      required:
        - items
      title: ListModelVersionsResponse
      description: Response for listing model versions.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
      description: Returned when request parameters or body fail validation.
    ModelVersion:
      properties:
        model_version_id:
          type: string
          format: uuid
          title: Model Version Id
        model_id:
          type: string
          format: uuid
          title: Model Id
        version:
          type: integer
          title: Version
        status:
          $ref: '#/components/schemas/ModelVersionStatus'
          description: Version status.
        dataset:
          anyOf:
            - $ref: '#/components/schemas/DatasetVersionRef'
            - type: 'null'
          description: Dataset version used for training.
        training_job_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Training Job Id
          description: Training job ID.
        metrics:
          anyOf:
            - additionalProperties:
                anyOf:
                  - type: number
                  - type: integer
              type: object
            - type: 'null'
          title: Metrics
          description: >-
            Validation metrics from training. Keys depend on model type:
            **prediction (classification):** `accuracy` (0–1). **prediction
            (regression):** `r2` (R-squared). **clustering:** `n_clusters`,
            `silhouette_score` (−1 to 1). Other model types do not produce
            metrics.
        created_at:
          type: string
          format: date-time
          title: Created At
        ready_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Ready At
          description: When the version became ready for inference.
      type: object
      required:
        - model_version_id
        - model_id
        - version
        - status
        - created_at
      title: ModelVersion
      description: |-
        Model version detail.

        Includes training configuration and status.  The ``dataset``
        field links back to the exact data used for training, enabling
        reproducibility.
    ValidationError:
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          type: array
          items:
            type: string
          title: Location
          description: Path to the field that caused the error.
        msg:
          type: string
          title: Message
          description: Human-readable error message.
        type:
          type: string
          title: Error Type
          description: Machine-readable error type identifier.
      title: ValidationError
    ModelVersionStatus:
      type: string
      enum:
        - queued
        - training
        - ready
        - failed
      title: ModelVersionStatus
    DatasetVersionRef:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        version_id:
          type: string
          format: uuid
          title: Version Id
        version_number:
          type: integer
          title: Version Number
      type: object
      required:
        - id
        - version_id
        - version_number
      title: DatasetVersionRef
      description: Dataset version reference.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````