> ## Documentation Index > Fetch the complete documentation index at: https://docs.veri.studio/llms.txt > Use this file to discover all available pages before exploring further. # List model versions > The lineage named `name`: every registered version (newest first), its aliases (`production`, `staging`, custom) and the alias audit trail (who moved what, from where, why). ## OpenAPI ````yaml /api-reference/openapi.json get /v1/models/{name}/versions openapi: 3.1.0 info: title: Veri API description: >- REST API for the Veri RL post-training platform. All requests require a Bearer API key (`vk_` prefix). license: name: '' version: 0.1.0 servers: - url: https://api.veri.studio description: Production security: [] tags: - name: Training jobs description: Create, monitor, and manage training jobs. - name: Datasets description: Upload and connect training datasets. - name: Deployments description: Serve trained models and run inference. - name: Volumes description: Persistent file storage mounted into jobs. - name: Models description: Custom model registry deployments serve from. - name: Regions description: Discover available launch regions. - name: GPU description: Live GPU availability by provider and region. - name: Compatibility description: Advisory model and runtime compatibility guidance. - name: Code artifacts description: Upload custom training script bundles. - name: Billing description: Credit balance and transaction history. - name: API keys description: Create and revoke API keys. - name: Account description: The authenticated caller's identity. - name: SSH keys description: Manage SSH key pairs for compute access. - name: Settings description: Account-level integrations (Weights & Biases). - name: Metrics description: Prometheus metrics export for your own observability stack. paths: /v1/models/{name}/versions: get: tags: - Models summary: List model versions description: >- The lineage named `name`: every registered version (newest first), its aliases (`production`, `staging`, custom) and the alias audit trail (who moved what, from where, why). operationId: list_versions parameters: - name: name in: path description: Lineage name required: true schema: type: string responses: '200': description: The lineage with versions, aliases and audit content: application/json: schema: $ref: '#/components/schemas/ModelLineageResponse' '404': description: No lineage with this name in the caller's workspace security: - bearerAuth: [] components: schemas: ModelLineageResponse: type: object description: A lineage with its versions, aliases and audit trail. required: - object - id - name - base_model - versions - aliases - audit - created_at - updated_at properties: object: type: string description: Always "model_lineage". id: type: string name: type: string base_model: type: string versions: type: array items: $ref: '#/components/schemas/ModelVersionResponse' description: Newest first. aliases: type: array items: $ref: '#/components/schemas/ModelAliasResponse' audit: type: array items: $ref: '#/components/schemas/ModelAliasAuditResponse' description: Newest first (capped at 100). created_at: type: string format: date-time updated_at: type: string format: date-time ModelVersionResponse: type: object description: One version of a lineage (`{name}@v{version}`). required: - object - id - model_id - model - version - name - artifact_type - tags - pinned - status - aliases - created_at properties: object: type: string description: Always "model_version". id: type: string description: Version id (mv...). model_id: type: string description: Lineage id. model: type: string description: Lineage name. version: type: integer format: int32 description: Dense, monotonic version number within the lineage. name: type: string description: 'Human handle: "{model}@v{version}".' custom_model_id: type: - string - 'null' description: |- The library model (custom_models row) whose weights this version is; deploy or attach by this id. artifact_type: type: string description: '''full'' | ''adapter''.' dataset_snapshot_id: type: - string - 'null' description: >- Dataset snapshot (Task 2) or plain dataset id the version was trained on. training_job_id: type: - string - 'null' parent_version_id: type: - string - 'null' description: The version `production` pointed at when this one was registered. tags: type: array items: type: string pinned: type: boolean description: Pinned versions are protected from retention. pinned_at: type: - string - 'null' format: date-time status: type: string description: >- 'ready' | 'purged' (Task 6, VS-84). A purged version still lists — number, tags, audit and scorecards stay — but its weights are deleted and it can no longer be deployed, attached or promoted. purged_at: type: - string - 'null' format: date-time aliases: type: array items: type: string description: Aliases currently pointing at this version. created_by: type: - string - 'null' created_at: type: string format: date-time ModelAliasResponse: type: object description: An alias of a lineage and the version it points at. required: - alias - version_id - updated_at properties: alias: type: string version_id: type: string version: type: - integer - 'null' format: int32 description: The version number the alias resolves to. updated_at: type: string format: date-time ModelAliasAuditResponse: type: object description: One audited alias move. required: - id - alias - to_version_id - actor - reason - at properties: id: type: string alias: type: string from_version_id: type: - string - 'null' from_version: type: - integer - 'null' format: int32 to_version_id: type: string to_version: type: - integer - 'null' format: int32 actor: type: string description: Who moved it ("api_key:", "web-proxy", "system:migration"). reason: type: string at: type: string format: date-time securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key description: API key with the `vk_` prefix. Create one from the dashboard. ````