---
title: "Get Version"
method: GET
path: "/api/v1/artifacts/{artifact_id}/versions/{numeric_id}"
tags: ["Artifact"]
---

# Get Version

`GET /api/v1/artifacts/{artifact_id}/versions/{numeric_id}`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/artifacts/{artifact_id}/versions/{numeric_id}`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

GetVersion returns the exact numbered version using strong canonical parent
 and version reads; Owners can inspect PENDING and FAILED, Readers only eligible READY versions.

## Path parameters

- `artifact_id` string, required: Identifier of the Artifact that owns the requested version.
- `numeric_id` string, int64, required: Positive exact version number; zero is not a version. JS clients use strings.

## Response `200`

ArtifactServiceGetVersionResponse contains the canonical publication outcome.

- C1ApiArtifactV1ArtifactServiceGetVersionResponse: ArtifactServiceGetVersionResponse contains the canonical publication outcome.
  - `version` C1ApiArtifactV1ArtifactVersion: ArtifactVersion is a redacted publication outcome identified by its parent and positive numeric ID. It contains no source or executable definition. Authorization uses the canonical parent Artifact policy resource; versions have no separate entitlement or policy identity. READY alone does not grant access: current role eligibility and live parent and child records are required, including for a previously published pin.
    - `artifactId` string: Identifier of the Artifact that owns this version.
    - `createdAt` string, date-time, nullable
    - `error` string: Safe failure summary, populated only for FAILED; never source text, secrets or detailed tool/backend errors. Consumers must enforce this condition.
    - `expectedPublishedVersionNumericId` string, int64: Exact publication pointer expected at admission; zero means unpublished. This expectation is not proof that publication succeeded.
    - `numericId` string, int64: Exact positive version number within this Artifact, displayed as v40. Gaps are allowed; JS clients use strings to preserve the full int64 range.
    - `state` 'ARTIFACT_VERSION_STATE_UNSPECIFIED' | 'ARTIFACT_VERSION_STATE_PENDING' | 'ARTIFACT_VERSION_STATE_READY' | 'ARTIFACT_VERSION_STATE_FAILED': Publication outcome. PENDING and FAILED are visible only to current Owners.
    - `viewerUrl` string: Server-generated pinned viewer link, not a download capability. Only an eligible READY version can be opened, with current grants checked each time.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/artifacts/:artifact_id/versions/:numeric_id/get.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) - [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)