---
title: "List packages"
method: GET
path: "/packages"
tags: ["Package"]
---

# List packages

`GET /packages`

## Request

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

List packages. The listing must be scoped: send `nrn`, `visible_to`, or both.

> 💡 **Tip:** Prefer `visible_to` for consumption. It matches packages owned at the NRN, shared by ancestors or trailing-wildcard scopes, and global packages published with `organization=*`. The `nrn` filter only matches packages owned at exactly that NRN.

The component filters (`component_name`, `resource_type`, `resource_id` and `resource_revision_id`) match against each package's resolved revision: `default_revision_id` when it's set, otherwise `latest_revision_id`.

## Query parameters

- `nrn` string
- `visible_to` string
- `slug` string
- `name` string
- `component_name` string
- `resource_type` string
- `resource_id` string, uuid
- `resource_revision_id` string, uuid
- `sort` string
- `offset` integer
- `limit` integer

## Response `200`

The packages matching the query.

- PackageListResponse
  - `paging` SchemasPaging
    - `offset` integer: The offset of this page.
    - `limit` integer: The maximum number of results in this page.
    - `total` integer: The total number of results that match the query.
  - `results` Package[]
    - `id` string, uuid: The package id.
    - `nrn` string: The owning NRN.
    - `slug` string: URL-safe identifier, unique per NRN. Derived from name when omitted on create.
    - `name` string: Human-readable display name.
    - `visible_to` string[]: NRNs allowed to consume (read and link) this package. Supports trailing-wildcard scopes (for example, "organization=1:account=*") and the global wildcard "organization=*". Defaults to [nrn]. Modifications stay gated on the owning NRN.
    - `default_revision_id` string, uuid, nullable: Pinned revision UUID, or null to follow latest_revision_id.
    - `default_version` string, nullable: Server-derived semver of default_revision_id.
    - `latest_revision_id` string, uuid, nullable: Highest-semver revision UUID. Server-managed.
    - `latest_version` string, nullable: Server-derived semver of latest_revision_id.
    - `components` PackageComponent[]: The bill of materials of the resolved revision (default_revision_id, or latest_revision_id when no default is pinned).
      - `name` string, required: Name of the component within the revision, for example "spec" or "runtime:main". Unique within the revision; opaque to the package server.
      - `resource_type` string, required: Routing key that identifies which owning service resolves resource_id, for example "service_specification", "action_specification", "link_specification" or "artifact".
      - `resource_id` string, uuid, required: UUID of the underlying resource at its owning service.
      - `resource_revision_id` string, uuid, required: UUID of the revision this component pins: a specification snapshot for service, action and link specifications, or an artifact revision for artifacts.
      - `parent_id` string, uuid, nullable: The resource_id of the parent component within this revision. Required for action_specification components (the parent is a service or link specification component) and link_specification components (the parent is a service specification component); null for service_specification and artifact components.
    - `created_at` string, date-time: When the package was created.
    - `updated_at` string, date-time: When the package envelope last changed.

## 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/packages/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)