---
title: "List Game Blueprints"
method: GET
path: "/api/blueprints"
tags: ["In-Game", "Blueprints"]
---

# List Game Blueprints

`GET /api/blueprints`

Returns paginated crafting blueprints, including ingredients, crafted items, and dismantle returns. Results are scoped to the requested or default game version.

## Query parameters

- `page` integer
- `page[number]` integer
- `page[size]` integer
- `version` string
- `sort` string
- `filter[query]` string
- `filter[output.uuid]` string, uuid
- `filter[output.name]` string
- `filter[output.class]` string
- `filter[output.type]` string
- `filter[default]` boolean
- `filter[ingredient]` string
- `filter[ingredient.uuid]` string, uuid
- `filter[resource.uuid]` string, uuid

## Response `200`

List of blueprints

- Blueprint[]
  - `uuid` string, uuid — Unique blueprint identifier
  - `key` string — Internal blueprint key (e.g. BP_CRAFT_behr_pistol_ballistic_01)
  - `category_uuid` string, uuid — UUID of the blueprint category
  - `output_item_uuid` string, uuid — UUID of the item this blueprint crafts
  - `output_name` string, nullable — Display name of the crafted item
  - `output_class` string, nullable — Internal class identifier of the crafted item
  - `craft_time_seconds` integer, nullable — Crafting duration in seconds
  - `craft_time_label` string, nullable — Human-readable crafting duration
  - `is_available_by_default` boolean — Whether this blueprint is available without unlocking
  - `game_version` string, nullable — Game version code this data applies to
  - `ingredient_count` integer — Total number of distinct ingredients across all requirement groups
  - `unlocking_missions_count` integer — Number of missions that can unlock this blueprint
  - `ingredients` BlueprintIngredient[] — Ingredients required to craft the item
    - `name` string, nullable — Display name of the ingredient
    - `kind` 'resource' | 'item', nullable — Ingredient kind
    - `resource_type_uuid` string, uuid, nullable — UUID of the ingredient resource type (see GET /api/commodities)
    - `item_uuid` string, uuid, nullable — UUID of the ingredient item (see GET /api/items)
    - `quantity_scu` number, float, nullable — Quantity in Standard Cargo Units (for resources)
    - `quantity` number, float, nullable — Discrete count (for items)
    - `link` string, uri, nullable — API URL for the ingredient
    - `web_url` string, uri, nullable — Web URL for the ingredient detail page
  - `dismantle_returns` BlueprintDismantleReturnSummary[] — Resources returned when dismantling the crafted item
    - `name` string, nullable — Display name of the returned resource
    - `resource_type_uuid` string, uuid, nullable — UUID of the returned resource type (see GET /api/commodities)
    - `quantity_scu` number, float, nullable — Quantity returned in Standard Cargo Units
    - `link` string, uri, nullable — API URL for the returned resource
    - `web_url` string, uri, nullable — Web URL for the returned resource detail page
  - `output` BlueprintOutput — Crafted output metadata for a blueprint.
    - `uuid` string, uuid, nullable — UUID of the crafted item
    - `name` string, nullable — Display name of the crafted item
    - `class` string, nullable — Internal class identifier of the crafted item
    - `type` string, nullable — Type category of the crafted item (e.g. WeaponPersonal, Char_Armor_Torso)
    - `type_label` string, nullable — Human-readable label for the type
    - `subtype` string, nullable — Sub-type classification of the crafted item
    - `grade` string, nullable — Grade or quality tier of the crafted item
    - `item_web_url` string, uri, nullable — Web URL for the crafted item detail page
  - `dismantle` BlueprintDismantle — Dismantle metadata for a blueprint. Only included on blueprint detail responses.
    - `time_seconds` integer, nullable — Dismantle duration in seconds
    - `time_label` string, nullable — Human-readable dismantle duration
    - `efficiency` number, float, nullable — Dismantle efficiency ratio
  - `requirement_groups` BlueprintRequirementGroup[] — Only included on blueprint detail responses.
    - `key` string, nullable — Internal key of the requirement group
    - `name` string, nullable — Display name of the requirement group
    - `kind` 'group' — Always "group"
    - `required_count` integer, nullable — Number of children that must be fulfilled within this group
    - `modifiers` BlueprintModifier[] — Quality-dependent modifier effects applied at the group level
      - `property_key` string — Internal key identifying the modifier property
      - `property_uuid` string, uuid, nullable — UUID of the property definition, if available
      - `label` string — Human-readable label for the modifier
      - `better_when` 'higher' | 'lower' | 'neutral', nullable — Indicates whether a higher or lower value is desirable
      - `quality_range` BlueprintModifierQualityRange
        - `min` number, float, nullable — Minimum quality value
        - `max` number, float, nullable — Maximum quality value
      - `modifier_range` BlueprintModifierRange
        - `at_min_quality` number, float, nullable — Modifier value at minimum quality
        - `at_max_quality` number, float, nullable — Modifier value at maximum quality
    - `children` BlueprintRequirementChild[] — Individual resources or items within this group
      - `key` string, nullable — Internal key of the requirement child
      - `kind` 'group' | 'resource' | 'item', nullable — Type of requirement entry
      - `uuid` string, uuid, nullable — UUID of the required resource type or item
      - `name` string, nullable — Display name of the required resource or item
      - `required_count` integer, nullable — Number of this child required within its group
      - `quantity` number, float, nullable — Discrete item count required
      - `quantity_scu` number, float, nullable — Quantity in Standard Cargo Units (for resources)
      - `min_quality` integer, nullable — Minimum quality tier required
      - `modifiers` BlueprintModifier[] — Quality-dependent modifier effects for this child
        - `property_key` string — Internal key identifying the modifier property
        - `property_uuid` string, uuid, nullable — UUID of the property definition, if available
        - `label` string — Human-readable label for the modifier
        - `better_when` 'higher' | 'lower' | 'neutral', nullable — Indicates whether a higher or lower value is desirable
        - `quality_range` BlueprintModifierQualityRange
          - `min` number, float, nullable — Minimum quality value
          - `max` number, float, nullable — Maximum quality value
        - `modifier_range` BlueprintModifierRange
          - `at_min_quality` number, float, nullable — Modifier value at minimum quality
          - `at_max_quality` number, float, nullable — Modifier value at maximum quality
      - `children` BlueprintRequirementChild[], nullable — Nested children when kind is group
  - `summary_properties` BlueprintSummaryProperty[] — Only included on blueprint detail responses.
    - `property_key` string — Internal key identifying the property
    - `property_uuid` string, uuid, nullable — UUID of the property definition, if available
    - `label` string — Human-readable label for the property
    - `better_when` 'higher' | 'lower' | 'neutral', nullable — Indicates whether a higher or lower value is desirable
  - `unlocking_missions` BlueprintUnlockingMission[] — Only included on blueprint detail responses.
    - `title` string, nullable — Formatted mission title
    - `debug_name` string, nullable — Internal debug name of the mission
    - `reward_scope` string, nullable — Scope of the blueprint reward
    - `chance` number, float, nullable — Drop chance as a decimal (e.g. 0.5 for 50%)
    - `web_url` string, uri, nullable — Web URL for the mission detail page
  - `tiers` BlueprintTier[] — Only included on blueprint detail responses.
    - `tier_index` integer, nullable — Zero-based index of this crafting tier
    - `craft_time_seconds` integer, nullable — Crafting duration in seconds for this tier
    - `requirements` BlueprintRequirementNode — Raw recursive requirement node returned under tiers[].requirements.
      - `kind` 'root' | 'group' | 'resource' | 'item', nullable — Node type in the requirement tree
      - `key` string, nullable — Internal key of the requirement node
      - `name` string, nullable — Display name of the requirement node
      - `uuid` string, uuid, nullable — UUID of the required resource type or item
      - `required_count` integer, nullable — Number of children that must be fulfilled
      - `quantity` number, float, nullable — Discrete item count required
      - `quantity_scu` number, float, nullable — Quantity in Standard Cargo Units (for resources)
      - `min_quality` integer, nullable — Minimum quality tier required
      - `modifiers` BlueprintModifier[], nullable — Quality-dependent modifier effects
        - `property_key` string — Internal key identifying the modifier property
        - `property_uuid` string, uuid, nullable — UUID of the property definition, if available
        - `label` string — Human-readable label for the modifier
        - `better_when` 'higher' | 'lower' | 'neutral', nullable — Indicates whether a higher or lower value is desirable
        - `quality_range` BlueprintModifierQualityRange
          - `min` number, float, nullable — Minimum quality value
          - `max` number, float, nullable — Maximum quality value
        - `modifier_range` BlueprintModifierRange
          - `at_min_quality` number, float, nullable — Modifier value at minimum quality
          - `at_max_quality` number, float, nullable — Modifier value at maximum quality
      - `children` BlueprintRequirementNode[], nullable — Nested child nodes in the requirement tree
  - `link` string, uri — API URL for this blueprint
  - `web_url` string, uri — Web URL for the blueprint detail page
  - `output_item_web_url` string, uri, nullable — Web URL for the crafted item detail page

## Changes

- **2026-04-24** `c096aa819d11` — 1 info
  - added the optional property `items/output/type_label` to the response with the `200` status
- **2026-04-22** `4276a69d4550` — 3 info
  - added the optional property `items/ingredients/items/item_uuid` to the response with the `200` status
  - added the optional property `items/ingredients/items/kind` to the response with the `200` status
  - added the optional property `items/ingredients/items/quantity` to the response with the `200` status
- **2026-04-19** `4efeaa4b4785` — 3 warning, 2 info
  - removed the optional property `items/availability` from the response with the `200` status
  - removed the optional property `items/dismantle/returns` from the response with the `200` status
  - removed the optional property `items/resources` from the response with the `200` status
  - added the optional property `items/unlocking_missions` to the response with the `200` status
  - …1 more
- **2026-04-06** `f578ff9203b8` — 8 info
  - added the new optional `query` request parameter `filter[resource.uuid]`
  - added the optional property `items/craft_time_label` to the response with the `200` status
  - added the optional property `items/dismantle` to the response with the `200` status
  - added the optional property `items/dismantle_returns` to the response with the `200` status
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/changes/api/blueprints/get.md)

---

[API](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api.md) · [All operations](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/llms.txt) · [OpenAPI document](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/revisions/5cd81baa02cb?raw)