---
id: package-installation-read
title: Read a package installation
description: >-
  Read an installation: the NRN it's installed at, where it's visible, and the
  revision new services and scopes are created with.
sidebar_label: Read a package installation
hide_title: true
hide_table_of_contents: true
api: >-
  eJztV21v2zYQ/ivEfUkLSI7sOGkjoMC6Yi/dh2JIM7RYEKQn8WSxlUiNpOxkhv/7cJRsS4n7sq0DNmCf9MIj+dzdw+eOa5Dkcqsar4yGFC4IpUAtlHYeqwr5dyp8SeLVxSuh/JHbDpEU6COxKslSN7BUTmUVRQK1DFMs8S+jhaaVcGSXKicXRl1uGn61JHJL6EmKlfLlBCIwDdmw7UsJKTSYf8AF3YzwWEIJEXhcOEiv4OfOZoQZriNo0GJNnixbrUHpsJ4vIQKNNUEKipex9FurLElIvW0pApeXVCOka/B3DVs5b5VeQASFsTV6SKFtlYRNdC92l+UYg1CSHaJbrJuKF3oin9J5kWA8zWZ5PJcnFJ8Xc4xPs7N8Owab6wgc5a1V/i7gzggt2eetLyG9uuZhS64x2pFjkLMk4cenoTCO3GhP2rMxNk2l8jBy/N7xjPVDt032nnIPETSWc+JVt5+Snw/NPxSZCLTVh3Z/uBuzlSnYbLkx5u1EvPTCrLQLRvcjtcdl7AK1+j2MPJummOem1f7ZjLHsqPn3AkJyCzIVKBaVybASRlMkjOWnuDOtFUMgAfgY5xRn2Uk+l/EpnRXxHJ9k8dP8XMYJTYsZnmTz/LQnbIFt5W+2J/Mvg//s0W61JCve9Zpw4827g6d978IWaZyfyrN4Tk+K+CmeZ3GST+WMToo5nmZDF5ZknTIH6aDbqsKMV+1O9Bj+a7JLsrEkq5YkhaN6SVaYQhwIzr0oT+aThDHsvRpsj9biHUSgPNXuIawHcvGmU07tlKRAw1GOB+Q9csI1lKuiP7JM5h5BiHjr2Nmg0i4wv0sELcne+VLphcioMiser0cOXX2c39ebCPpc3WR3fz7IzJHWkRWr0gyYPvAq8JsXGcf4PWqaSEPf9L8mualhAAb9Jwkr0VPsVU0PWPumpFFUxQoHmjAGMUtmZ3FyHk/nl9NZmiRpkkySJPmVgbSN/EpARopYofMiL1EvvhzMJgKvfDDqnXo5LIGbDVvM3759WB9eVIq0F2StsWJXToRsSXjO1xIrJYXSTesjUSvnmEX7esqpU9q1RaHysFBDNliZTpi+UqlxHn3rXhhJA1ulPS3IDkM0TxJmyNhul5J9JDOUN1ztyXnOZPD+0zO+RSku9jNqcg4XB3cZx/fHtkYdc5/CR0TQbVOhPlBfLrYyehS05UjQrXLeBXkUKKQqCrIc4ExVFWtUjZ6swsqJRzsJ/hLlfDxiS/D8ok97z5PTQzzptPI+T/5P8X8xxcE5XxpuqxcUUsHNcArHh5psd7xWcgPcizIFuha6tRWkUHrfuPT4GBs1YQFvKvSse51UD9rX10yCLs/DJnYXWV4I+oY7JC8YQdS/fL/V0p/eXAbflC5Cwd2VfphOkkkCe6/7q0Boz4zzNQYy9t1+d7fZt4RDrbyX3fWe3/+CK1EfLk+3/ripUOlQhzgX6z6HVwcvSg4iSJXku1BpnGez9TpDR7/YarPh37+1ZPmWcR3BEq3q6vnVGqQKPYWEtMDK3a/uw+g8uuivT4/FR7r8g+i3PZPmjmmJVctfEMEHuuvuZRvuQEpCSTYg6gae5zk1fjDlgfYw/3Y0/+G7S4gAx6y7x7Kw+kE463VncWk+kN5sdug8fzPAzeYPjLU4bQ==
sidebar_class_name: get api-method
info_path: docs/api/package
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/package-installation-read'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Read a package installation"}
>
</Heading>

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

</MethodEndpoint>

Read an installation: the NRN it's installed at, where it's visible, and the revision new services and scopes are created with.

<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 installation id.","example":"7d8e9f0a-1b2c-4d3e-9f4a-5b6c7d8e9f0a"}]}
>

</ParamsDetails>

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

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The installation.","content":{"application/json":{"schema":{"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"}}}},"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>

