---
id: package-revision-read-standalone
title: "Read a package revision directly by id"
description: "Read a package revision when you only have its id, for example a service's `package_revision_id`. Authorized against the parent package."
sidebar_label: "Read a package revision directly by id"
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
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Read a package revision directly by id"}
>
</Heading>

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



Read a package revision when you only have its id, for example a service's `package_revision_id`. Authorized against the parent package.

<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 package revision id.","example":"e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The package revision.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The revision id. This is what a service's `package_revision_id` points at.","example":"e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"},"package_id":{"type":"string","format":"uuid","description":"The package this revision belongs to.","example":"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"},"version":{"type":"string","description":"Semver of this revision.","example":"1.4.0"},"parent_revision_id":{"type":"string","format":"uuid","nullable":true,"description":"The package's latest revision when this one was published.","example":"c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f"},"parent_version":{"type":"string","nullable":true,"description":"Semver of parent_revision_id, or null for a first revision.","example":"1.3.0"},"slug":{"type":"string","description":"The package's slug.","example":"my-scope"},"name":{"type":"string","description":"The package's name.","example":"My scope"},"components":{"type":"array","items":{"type":"object","required":["name","resource_type","resource_id","resource_revision_id"],"description":"One entry of the bill of materials: a pinned (resource, revision) pair.","properties":{"name":{"type":"string","minLength":1,"description":"Name of the component within the revision, for example \"spec\" or \"runtime:main\". Unique within the revision; opaque to the package server.","example":"spec"},"resource_type":{"type":"string","minLength":1,"description":"Routing key that identifies which owning service resolves resource_id, for example \"service_specification\", \"action_specification\", \"link_specification\" or \"artifact\".","example":"service_specification"},"resource_id":{"type":"string","format":"uuid","description":"UUID of the underlying resource at its owning service.","example":"7b2d1c5e-8f4a-4e3b-9c6d-1a2b3c4d5e6f"},"resource_revision_id":{"type":"string","format":"uuid","description":"UUID of the revision this component pins: a specification snapshot for service, action and link specifications, or an artifact revision for artifacts.","example":"0c9e8d7f-6a5b-4c3d-8e2f-1a0b9c8d7e6f"},"parent_id":{"type":"string","format":"uuid","nullable":true,"description":"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.","example":null}},"title":"packageComponent"},"description":"The revision's bill of materials. Omitted on `GET /packages/{id}/revisions` unless you filter by `name`."},"created_at":{"type":"string","format":"date-time","description":"When the revision was published.","example":"2026-09-14T12:00:00.000Z"},"created_by":{"type":"string","nullable":true,"description":"The user who published the revision, or null.","example":"jane.doe@example.com"}},"title":"packageRevision"}}}},"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>