NUnullplatform
Package

List packages

Changed on

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.

get/packages

Request

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

Query parameters

nrnstring

Filter by exact owner NRN. Required unless you send visible_to.

visible_tostring

Return packages visible at this NRN: ancestors, trailing-wildcard scopes and the global wildcard all match. A trailing-wildcard value (for example, "organization=1:account=*") also matches packages visible to any of its descendants. Required unless you send nrn.

slugstring

Filter by exact slug. Combine it with nrn to resolve a slug to a package id.

namestring

Filter by name substring (case-insensitive).

component_namestring

Filter to packages whose resolved revision has a component with this name.

resource_typestring

Filter to packages whose resolved revision has a component of this resource type (for example, service_specification or artifact).

resource_idstring uuid

Filter to packages whose resolved revision pins this resource, at any revision.

resource_revision_idstring uuid

Filter to packages whose resolved revision pins exactly this resource revision.

sortstring

Sort as field:direction, where field is one of created_at, updated_at, name or slug.

offsetinteger

The starting point for pagination.

limitinteger

The maximum number of results to return per page.

Response

The packages matching the query.

Example response

{
  "paging": {
    "limit": 20,
    "total": 3
  },
  "results": [
    {
      "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "nrn": "organization=1:account=2",
      "slug": "my-scope",
      "name": "My scope",
      "visible_to": [
        "organization=1:account=2"
      ],
      "default_revision_id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
      "default_version": "1.4.0",
      "latest_revision_id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
      "latest_version": "1.4.0",
      "components": [
        {
          "name": "spec",
          "resource_type": "service_specification",
          "resource_id": "7b2d1c5e-8f4a-4e3b-9c6d-1a2b3c4d5e6f",
          "resource_revision_id": "0c9e8d7f-6a5b-4c3d-8e2f-1a0b9c8d7e6f"
        }
      ],
      "created_at": "2026-09-14T12:00:00.000Z",
      "updated_at": "2026-09-14T12:00:00.000Z"
    }
  ]
}

Changes