---
title: "Get Package Blueprints Page"
method: POST
path: "/state/package/page/blueprints"
tags: ["State"]
---

# Get Package Blueprints Page

`POST /state/package/page/blueprints`

Returns all the blueprints associated with a given package entity.
The returned response is in a paginated format, ordered by first appearance on the ledger.

## Request body

- StatePackageBlueprintPageRequest — defines upper boundary (inclusive) for queried data. i.e `{ "at_state_version" = {"epoch" = 10} }`, will return data till 10 epoch.
  - `at_ledger_state` LedgerStateSelector, nullable — Optional. This allows for a request to be made against a historic state. If a constraint is specified, the Gateway will resolve the request against the ledger state at that time. If not specified, requests will be made with respect to the top of the committed ledger.
    - `state_version` integer, nullable — If provided, the latest ledger state lower than or equal to the given state version is returned.
    - `timestamp` string, date-time, nullable — If provided, the latest ledger state lower than or equal to the given round timestamp is returned.
    - `epoch` integer, nullable — If provided, the ledger state lower than or equal to the given epoch at round 0 is returned.
    - `round` integer, nullable — If provided must be accompanied with `epoch`, the ledger state lower than or equal to the given epoch and round is returned.
  - `cursor` string, nullable — This cursor allows forward pagination, by providing the cursor from the previous request.
  - `limit_per_page` integer, nullable — The page size requested.
  - `package_address` string, required — Bech32m-encoded human readable version of the address.

## Response `200`

Package Blueprints (paginated)

- StatePackageBlueprintPageResponse — Package blueprint collection.
  - `ledger_state` LedgerState, required — The ledger state against which the response was generated. Can be used to detect if the Network Gateway is returning up-to-date information.
    - `network` string, required — The logical name of the network
    - `state_version` integer, required — The state version of the ledger. Each transaction increments the state version by 1.
    - `proposer_round_timestamp` string, required — The proposer round timestamp of the consensus round when this transaction was committed to ledger. This is not guaranteed to be strictly increasing, as it is computed as an average across the validator set. If this is significantly behind the current timestamp, the Network Gateway is likely reporting out-dated information, or the network has stalled.
    - `epoch` integer, required — The epoch number of the ledger at this state version.
    - `round` integer, required — The consensus round in the epoch that this state version was committed in.
  - `total_count` integer, nullable — Total number of items in underlying collection, fragment of which is available in `items` collection.
  - `next_cursor` string, nullable — If specified, contains a cursor to query next page of the `items` collection.
  - `items` PackageBlueprintCollectionItem[], required
    - `name` string, required
    - `version` string, required
    - `definition` object, required — This type is defined in the Core API as `BlueprintDefinition`. See the Core API documentation for more details.
    - `dependant_entities` Address[]
    - `auth_template` object — This type is defined in the Core API as `AuthConfig`. See the Core API documentation for more details.
    - `auth_template_is_locked` boolean, nullable
    - `royalty_config` BlueprintRoyaltyConfig
      - `is_enabled` boolean, required
      - `method_rules` BlueprintMethodRoyalty[] — The royalty rules by method. The array is only present if royalties are enabled.
        - `method_name` string, required
        - `royalty_amount` RoyaltyAmount
          - `amount` string, required — String-encoded decimal representing the amount of a related fungible resource.
          - `unit` 'XRD' | 'USD', required
    - `royalty_config_is_locked` boolean, nullable
  - `package_address` string, required — Bech32m-encoded human readable version of the address.

## Other responses

- `4XX` — Client-originated request error

---

[API](https://skmtc.net/radixdlt/apis/radix-gateway-api-babylon.md) · [All operations](https://skmtc.net/radixdlt/apis/radix-gateway-api-babylon/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/radixdlt/radix-gateway-api-babylon/revisions/153aecf74342/schema)