---
id: package-installation-list
title: List package installations
description: >-
  List the installations owned at an NRN. `nrn` matches the installation's own
  NRN exactly.
sidebar_label: List package installations
hide_title: true
hide_table_of_contents: true
api: >-
  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
sidebar_class_name: get api-method
info_path: docs/api/package
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/package-installation-list'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List package installations"}
>
</Heading>

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

</MethodEndpoint>

List the installations owned at an NRN. `nrn` matches the installation's own NRN exactly.

> 💡 **Tip:** To see everything installed in an organization, send the organization's NRN with `show_descendants=true`.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"nrn","required":true,"schema":{"type":"string"},"description":"The NRN whose installations to list.","example":"organization=1:account=2"},{"in":"query","name":"package_id","schema":{"type":"string","format":"uuid"},"description":"Return only the installations of this package.","example":"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"},{"in":"query","name":"show_descendants","schema":{"type":"boolean","default":false},"description":"Also list the installations owned below `nrn`: its accounts, namespaces and applications.","example":true},{"in":"query","name":"sort","schema":{"type":"string","pattern":"^(created_at|updated_at|nrn):(asc|desc)$"},"description":"Sort as `field:direction`, where field is one of `created_at`, `updated_at` or `nrn`.","example":"created_at:desc"},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination.","example":0},{"in":"query","name":"limit","schema":{"type":"integer"},"description":"The maximum number of results to return per page.","example":20}]}
>

</ParamsDetails>

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

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The installations matching the query.","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},"total":{"type":"integer","minimum":0,"description":"The total number of results that match the query.","example":3}},"title":"paging"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The installation id.","example":"7d8e9f0a-1b2c-4d3e-9f4a-5b6c7d8e9f0a"},"nrn":{"type":"string","description":"The NRN the package is installed at. It owns the installation.","example":"organization=1:account=2"},"package_id":{"type":"string","format":"uuid","description":"The installed package: a global one, or one your organization owns.","example":"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"},"default_revision_id":{"type":"string","format":"uuid","description":"The revision new services and scopes under `visible_to` are created with.","example":"e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"},"default_version":{"type":"string","nullable":true,"description":"Server-derived semver of default_revision_id.","example":"1.4.0"},"visible_to":{"type":"array","items":{"type":"string"},"description":"Where inside the organization the package's specification is visible and usable: these NRNs and everything below them.","example":["organization=1:account=2"]},"created_by":{"type":"string","nullable":true,"description":"The user who installed the package, or null.","example":"jane.doe@example.com"},"created_at":{"type":"string","format":"date-time","description":"When the package was installed.","example":"2026-09-14T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"When the installation last changed.","example":"2026-09-14T12:00:00.000Z"}},"title":"packageInstallation"}}},"title":"packageInstallationListResponse"}}}},"4XX":{"description":"Client error responses due to invalid input, missing parameters or insufficient permissions.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":400},"code":{"type":"string","example":"bad_request"},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"Revision '1.4.0' exists with a different bill of materials (revision e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b)"}},"title":"errorResponse"}}}},"5XX":{"description":"Server error responses.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":400},"code":{"type":"string","example":"bad_request"},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"Revision '1.4.0' exists with a different bill of materials (revision e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b)"}},"title":"errorResponse"}}}}}}
>

</StatusCodes>

