---
id: artifact-revision-read
title: "Read an artifact revision"
description: "Read one revision of an artifact: its full meta blob and annotations."
sidebar_label: "Read an artifact revision"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/artifact
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Read an artifact revision"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/artifacts/{id}/revisions/{revisionId}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Read one revision of an artifact: its full meta blob and annotations.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The artifact id.","example":"5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f"},{"in":"path","name":"revisionId","required":true,"schema":{"type":"string","format":"uuid"},"description":"The revision id.","example":"2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The artifact revision.","content":{"application/json":{"schema":{"type":"object","description":"One immutable revision, identified by the ids a package component pins.","properties":{"resource_id":{"type":"string","format":"uuid","description":"The parent artifact id (a package component's resource_id).","example":"5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f"},"resource_revision_id":{"type":"string","format":"uuid","description":"The revision id (a package component's resource_revision_id).","example":"2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e"},"type":{"type":"string","enum":["oci_image","oras_artifact","git_repository","blob"],"description":"The parent artifact's type.","example":"oci_image"},"meta":{"type":"object","additionalProperties":true,"description":"Flat meta blob. Its shape depends on `type`:\n\n- `oci_image`: `registry` and `repository` (strings), `digest` (`sha256:` followed by 64 lowercase hex characters), and an optional `tag` (an OCI tag, up to 128 characters).\n- `oras_artifact`: `registry`, `repository` and `digest` (same rules as `oci_image`), and an optional `artifact_media_type` string.\n- `git_repository`: `url` and `reference` (any non-empty ref, such as a commit SHA, tag or branch). The url must not embed credentials: a password is rejected in any form, a user is rejected over http(s) (a user such as `git@` is allowed over ssh and the scp-like `user@host:path` form), and a url with a scheme must not carry a query string or fragment.\n- `blob`: `location` (starting with `s3://`, `gs://`, `https://` or `http://`), `sha256` (64 lowercase hex characters), and an optional `size_bytes` (non-negative integer).\n\nAny key not listed for the type is rejected, and so is an explicit `null` value: omit the key instead.\n\n> ℹ️ **Note:** A `git_repository` artifact is a pointer only. nullplatform never stores the repository content, so never commit secrets to a referenced repository.\n","example":{"registry":"123456789012.dkr.ecr.us-east-1.amazonaws.com","repository":"my-org/my-scope","digest":"sha256:4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945","tag":"v1.4.0"},"title":"artifactMeta"},"annotations":{"type":"object","additionalProperties":true,"nullable":true,"description":"The revision's annotations (see the registration body), or null when it has none."},"nrn":{"type":"string","description":"The parent artifact's owning NRN.","example":"organization=1:account=2"},"visible_to":{"type":"array","items":{"type":"string"},"description":"The parent artifact's visibility.","example":["organization=1:account=2"]},"created_at":{"type":"string","format":"date-time","description":"When the revision was registered.","example":"2026-09-14T12:00:00.000Z"}},"title":"artifactRevision"}}}},"4XX":{"description":"Client error responses due to invalid input, missing parameters or insufficient permissions.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400},"code":{"type":"string","description":"Machine-readable error code.","example":"bad_request"},"error":{"type":"string","description":"Short error name.","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"meta.digest must match sha256:<64-hex>"}},"title":"errorResponse"}}}},"5XX":{"description":"Server error responses.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400},"code":{"type":"string","description":"Machine-readable error code.","example":"bad_request"},"error":{"type":"string","description":"Short error name.","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"meta.digest must match sha256:<64-hex>"}},"title":"errorResponse"}}}}}}
>
  
</StatusCodes>