> ## Documentation Index > Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get a model version > Return the immutable version metadata, file manifest, and source training run. ## OpenAPI ````yaml /api-reference/openapi.json get /model-versions/{modelVersionId} openapi: 3.1.0 info: description: >- Manage projects, datasets, labeling pipelines, and model training. **Beta:** endpoints, request and response shapes, and error contracts can change without notice or a backward-compatibility promise. title: Toloka Platform API version: 2.0.0 servers: - url: https://platform.toloka.ai/api/v2-beta security: - apiKeyAuth: [] - scopedTokenAuth: [] tags: - description: The authenticated API key owner. name: Account - description: A project is the container for pipelines, datasets, and files. name: Projects - description: Rows and typed fields. Field schemas are immutable once created. name: Datasets - description: Append rows to a dataset from a file. name: Dataset uploads - description: Read a dataset out as a file. name: Dataset exports - description: A pipeline is a graph of nodes that processes each dataset item. name: Pipelines - description: The nodes, connections, fields, and version of a pipeline graph. name: Pipeline graph - description: Execute a pipeline over a dataset and inspect each item. name: Runs - description: Per-node checks that a pipeline must pass before deployment. name: Checks - description: Named credentials available to pipeline code. name: Secrets - description: Project files available to pipeline code and labeling interfaces. name: Files - description: >- Global, read-only catalog of the models a synthetic generation node can use, with their budget bounds. name: Generation models - description: >- Global, read-only catalog of the expert audience: the values a node `audience` filter can use. name: Audience - description: >- Project lists of experts a node can take its workforce from with `audienceMode: service`. Available only to teams with the audience service enabled. name: Expert lists - description: >- Experts banned in a project: they cannot be invited and are removed from the work they are in. Available only to teams with expert bans enabled. name: Expert ban list - description: Global, read-only base model catalog. name: Base models - description: Project-owned mutable model-training drafts. name: Trainings - description: Project-owned Models and immutable Model Versions. name: Models - name: Batch inference paths: /model-versions/{modelVersionId}: get: tags: - Models summary: Get a model version description: >- Return the immutable version metadata, file manifest, and source training run. operationId: getModelVersion parameters: - in: path name: modelVersionId required: true schema: $ref: '#/components/schemas/ModelVersionId' responses: '200': content: application/json: schema: $ref: '#/components/schemas/ModelVersion' description: Model Version headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' X-Request-Id: $ref: '#/components/headers/X-Request-Id' '429': description: Rate limit exceeded headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' X-Request-Id: $ref: '#/components/headers/X-Request-Id' x-codeSamples: - label: TypeScript SDK lang: typescript source: | import { createClient } from "@toloka-platform/sdk"; const client = createClient({ baseUrl: "https://platform.toloka.ai", apiKey: process.env.TOLOKA_API_KEY!, }); const version = await client.models.getVersion({ modelVersionId: "mdv.019a0000-0000-7000-8000-000000000001" }); console.log(version); components: schemas: ModelVersionId: description: Model version ID with prefix `mdv.`. pattern: >- ^mdv\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ type: string ModelVersion: description: One immutable version of a project Model. properties: content: description: >- Model weights or LoRA adapter, its base model, parent, and file manifest. oneOf: - additionalProperties: false properties: kind: const: lora_adapter description: >- Content kind: `lora_adapter` contains an adapter; `full` contains complete model weights. type: string manifest: $ref: '#/components/schemas/ModelVersionManifest' parent: $ref: '#/components/schemas/ModelVersionParent' runtimeBase: description: >- Catalog base model required to run these weights or this adapter. enum: - qwen3-4b - qwen3-8b - qwen3-32b - qwen3-235b type: string required: - runtimeBase - manifest - kind - parent type: object - additionalProperties: false properties: kind: const: full description: >- Content kind: `lora_adapter` contains an adapter; `full` contains complete model weights. type: string manifest: $ref: '#/components/schemas/ModelVersionManifest' parent: $ref: '#/components/schemas/ModelVersionParent' runtimeBase: description: >- Catalog base model required to run these weights or this adapter. enum: - qwen3-4b - qwen3-8b - qwen3-32b - qwen3-235b type: string required: - runtimeBase - manifest - kind type: object createdAt: description: Time the model version was created, as an ISO 8601 timestamp. format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ type: string id: $ref: '#/components/schemas/ModelVersionId' modelId: $ref: '#/components/schemas/ModelId' name: description: Name of this model version. maxLength: 120 minLength: 1 type: string producer: additionalProperties: false description: Training run that produced this model version. properties: trainingRunId: description: >- ID of the training run that produced the version, with prefix `trn.`. pattern: >- ^trn\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ type: string type: const: training_run description: >- Producer kind; `training_run` means this version was produced by a training run. type: string required: - type - trainingRunId type: object revision: description: Positive revision number assigned to this version within its model. exclusiveMinimum: 0 maximum: 9007199254740991 type: integer required: - id - modelId - name - revision - content - producer - createdAt type: object ModelVersionManifest: description: Files that make up the model version, with sizes and checksums. items: additionalProperties: false properties: byteSize: description: Size of this file in bytes. maximum: 10737418240 minimum: 0 type: integer mediaType: description: >- File media type: `application/json` for JSON files or `application/octet-stream` for binary files. enum: - application/octet-stream - application/json type: string path: description: >- Relative file path within the model version; absolute paths and parent-directory segments are not allowed. maxLength: 512 minLength: 1 pattern: >- ^(?!\/)(?!.*(?:^|\/)\.{1,2}(?:\/|$))[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*$ type: string sha256: description: >- SHA-256 checksum of the file, as 64 lowercase hexadecimal characters. pattern: ^[0-9a-f]{64}$ type: string required: - path - byteSize - mediaType - sha256 type: object maxItems: 64 minItems: 1 type: array ModelVersionParent: description: >- Parent model source; may be absent for full weights with no recorded parent. oneOf: - additionalProperties: false properties: baseModelId: description: Catalog base model identifier. enum: - qwen3-4b - qwen3-8b - qwen3-32b - qwen3-235b type: string type: const: base_model description: >- Parent source: `base_model` for a catalog model or `model_version` for a published project version. type: string required: - type - baseModelId type: object - additionalProperties: false properties: modelVersionId: description: Parent model version ID with prefix `mdv.`. pattern: >- ^mdv\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ type: string type: const: model_version description: >- Parent source: `base_model` for a catalog model or `model_version` for a published project version. type: string required: - type - modelVersionId type: object ModelId: description: Model ID with prefix `mdl.`. pattern: >- ^mdl\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ type: string headers: RateLimit-Limit: description: The maximum number of requests allowed in the current window. schema: type: integer RateLimit-Policy: description: The rate limit policy (e.g., "60;w=60"). schema: type: string RateLimit-Remaining: description: The number of requests remaining in the current window. schema: type: integer RateLimit-Reset: description: The number of seconds until the current window resets. schema: type: integer X-Request-Id: description: >- The request id: the X-Request-Id you sent when it is 1-128 characters of letters, digits, ".", "_" or "-", otherwise a generated UUID. Present on every response, including errors; quote it when reporting a problem. schema: type: string securitySchemes: apiKeyAuth: description: >- Enter `ApiKey ` in Authorization, including the `ApiKey ` prefix. In cURL and Python samples, `` means this full value. The TypeScript SDK adds the prefix for you. in: header name: Authorization type: apiKey scopedTokenAuth: description: >- Enter the project-scoped token as `pst_...` in X-Scoped-Token, without an `ApiKey ` prefix. Create a token with POST /projects/{projectId}/tokens. in: header name: X-Scoped-Token type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.