---
title: "List platform artifacts"
method: GET
path: "/artifacts"
tags: ["Artifact"]
---

# List platform artifacts

`GET /artifacts`

## Request

- Base URL: `https://api.nullplatform.com`
- URL: `https://api.nullplatform.com/artifacts`
- Auth: HTTP bearer

List artifacts.

Prefer the `visible_to` filter for consumption. It matches artifacts owned at the NRN, shared by ancestors or trailing-wildcard scopes, and global artifacts published with `organization=*`, which an owner `nrn` filter never returns.

`id` accepts up to 200 comma-separated ids as a batched read. Every requested artifact must be readable by the caller.

## Query parameters

- `nrn` string
- `visible_to` string
- `type` 'oci_image' | 'oras_artifact' | 'git_repository' | 'blob'
- `id` string
- `sort` string
- `offset` integer
- `limit` integer

## Response `200`

The artifacts matching the query.

- ArtifactListResponse
  - `paging` Paging
    - `offset` integer: The offset of this page.
    - `limit` integer: The maximum number of results in this page.
  - `results` Artifact[]
    - `resource_id` string, uuid: The artifact id.
    - `type` 'oci_image' | 'oras_artifact' | 'git_repository' | 'blob': The artifact type, which decides the shape of `identity_meta` and of every revision's `meta`.
    - `nrn` string: The owning NRN. When you belong to a different organization than the owner (a shared or global artifact), the response shows `organization=<your organization>` instead, and `visible_to` keeps only your own entries plus `organization=*`.
    - `identity_meta` object: The identity subset of the meta blob: registry and repository, url (plus path when set), or location, depending on type.
    - `visible_to` string[]: NRNs allowed to consume (read and link) this artifact. Supports trailing-wildcard scopes (for example, "organization=1:account=*") and the global wildcard "organization=*". Defaults to [nrn]. Modifications stay gated on the owning NRN.
    - `revision_count` integer: How many revisions the artifact has.
    - `latest_revision_id` string, uuid, nullable: The newest revision, or null when the artifact has none.
    - `created_at` string, date-time: When the artifact was first registered.

## Other responses

- `4XX`: Client error responses due to invalid input, missing parameters or insufficient permissions.
- `5XX`: Server error responses.

## Changes

- **2026-09-17** `43b3c1ecdfd8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nullplatform/apis/nullplatform-api/changes/artifacts/get.md)

---

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