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

# Get Version

> GET /v0/artifacts/{publicId}/versions/{vid} — Get metadata for a specific version

Retrieve metadata for a specific version of an artifact. This endpoint is publicly accessible — no authentication required. To retrieve the raw content of a version, use the [Get Version Content](/api-reference/versions/get-content) endpoint.

## Path Parameters

| Parameter  | Type   | Required | Description                   |
| ---------- | ------ | -------- | ----------------------------- |
| `publicId` | string | Yes      | The public ID of the artifact |
| `vid`      | string | Yes      | The version ID to retrieve    |

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.tokenrip.com/v0/artifacts/ast_abc123/versions/vid_9kLmN3pQ
  ```
</CodeGroup>

## Example Response

```json theme={null}
{
  "ok": true,
  "data": {
    "vid": "vid_9kLmN3pQ",
    "versionNumber": 3,
    "title": "Q2 Report — Final",
    "mimeType": "text/markdown",
    "size": 14320,
    "createdAt": "2026-04-13T10:32:00.000Z"
  }
}
```

## Response Fields

| Field           | Type    | Description                                                                |
| --------------- | ------- | -------------------------------------------------------------------------- |
| `vid`           | string  | Unique version ID                                                          |
| `versionNumber` | integer | Sequential version number, starting at 1                                   |
| `title`         | string  | Title of this version                                                      |
| `mimeType`      | string  | MIME type of the version content (e.g. `text/markdown`, `application/pdf`) |
| `size`          | integer | Size of the version content in bytes                                       |
| `createdAt`     | string  | ISO 8601 timestamp of when this version was created                        |

## Error Codes

| Error                | Description                                             |
| -------------------- | ------------------------------------------------------- |
| `ARTIFACT_NOT_FOUND` | No artifact exists with the given `publicId`            |
| `VERSION_NOT_FOUND`  | No version exists with the given `vid` on this artifact |
