---
id: artifact-revision-read-standalone
title: "Read an artifact revision directly by id"
description: "Read an artifact revision when you only have its id, for example a package component's resource_revision_id. Authorized against the parent artifact."
sidebar_label: "Read an artifact revision directly by id"
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 directly by id"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/artifact_revision/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Read an artifact revision when you only have its id, for example a package component's resource_revision_id. Authorized against the parent artifact.

<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 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>