---
id: artifact-revisions-list
title: "List revisions of an artifact"
description: "List the revisions of one artifact, newest first. Each revision carries the full meta blob it pins."
sidebar_label: "List revisions of an artifact"
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={"List revisions of an artifact"}
>
</Heading>

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



List the revisions of one artifact, newest first. Each revision carries the full meta blob it pins.

<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"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The artifact's revisions.","content":{"application/json":{"schema":{"type":"object","properties":{"paging":{"type":"object","properties":{"offset":{"type":"integer","description":"The offset of this page.","example":0},"limit":{"type":"integer","description":"The maximum number of results in this page.","example":20}},"title":"paging"},"results":{"type":"array","items":{"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"}}},"title":"artifactRevisionListResponse"}}}},"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>