---
title: "List Game Blueprints"
method: GET
path: "/api/blueprints"
tags: ["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

- object
  - `data` 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
      - `sub_type` string, nullable — Sub-type classification of the crafted item
      - `subtype` string, nullable — Deprecated: Use sub_type.
      - `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
        - `value_range_type` 'linear', nullable — Interpolation type for the modifier value range. When present, value_segments should be used for interpolation instead of the simple quality_range/modifier_range pair.
        - `value_segments` object[], nullable — Multi-step interpolation segments. Each segment defines its own quality range and modifier start/end values. When present, use these for interpolation instead of quality_range/modifier_range.
          - `quality_min` integer — Start quality for this segment
          - `quality_max` integer — End quality for this segment
          - `modifier_at_start` number, float — Modifier value at quality_min
          - `modifier_at_end` number, float — Modifier value at quality_max
      - `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
          - `value_range_type` 'linear', nullable — Interpolation type for the modifier value range. When present, value_segments should be used for interpolation instead of the simple quality_range/modifier_range pair.
          - `value_segments` object[], nullable — Multi-step interpolation segments. Each segment defines its own quality range and modifier start/end values. When present, use these for interpolation instead of quality_range/modifier_range.
            - `quality_min` integer — Start quality for this segment
            - `quality_max` integer — End quality for this segment
            - `modifier_at_start` number, float — Modifier value at quality_min
            - `modifier_at_end` number, float — Modifier value at quality_max
        - `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
    - `unlocking_missions_grouped` BlueprintUnlockingMissionsGrouped[] — Only included on blueprint detail responses.
      - `label` string — Human-readable chance label (e.g. Guaranteed, 50% chance)
      - `chance` number, float, nullable — Drop chance as a decimal
      - `missions` BlueprintUnlockingMissionsGroupedEntry[] — Missions in this chance group
        - `title` string — Mission title
        - `reward_scope` string, nullable — Scope of the blueprint reward
        - `count` integer — Number of occurrences of this mission
        - `web_url` string, uri, nullable — Web URL for the mission detail page
    - `aspects` BlueprintAspects — Interactive aspect tree for blueprint quality simulation. Only included on blueprint detail responses.
      - `aspects` BlueprintAspect[] — Flat list of all aspects
        - `key` string — Internal key of the aspect
        - `name` string — Display name of the aspect
        - `required_count` integer, nullable — Required count from parent group
        - `selection_group` BlueprintAspectSelectionGroup — Selection group metadata when multiple aspect options are available.
          - `key` string — Internal key of the selection group
          - `name` string — Display name of the selection group
          - `required_count` integer — Number of options that must be selected
          - `option_count` integer — Total number of available options
        - `input` BlueprintAspectInput — Input resource or item for a blueprint aspect.
          - `kind` string — Input kind
          - `uuid` string, uuid, nullable — UUID of the input resource or item
          - `name` string — Display name of the input
          - `quantity` number, float, nullable — Discrete count (for items)
          - `quantity_scu` number, float, nullable — Quantity in Standard Cargo Units (for resources)
          - `min_quality` integer — Minimum quality tier
          - `web_url` string, uri, nullable — Web URL for the input detail page
        - `modifiers` BlueprintModifier[] — 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
          - `value_range_type` 'linear', nullable — Interpolation type for the modifier value range. When present, value_segments should be used for interpolation instead of the simple quality_range/modifier_range pair.
          - `value_segments` object[], nullable — Multi-step interpolation segments. Each segment defines its own quality range and modifier start/end values. When present, use these for interpolation instead of quality_range/modifier_range.
            - `quality_min` integer — Start quality for this segment
            - `quality_max` integer — End quality for this segment
            - `modifier_at_start` number, float — Modifier value at quality_min
            - `modifier_at_end` number, float — Modifier value at quality_max
        - `initial_quality` integer — Default quality slider position
        - `slider_min` integer — Minimum quality slider value
        - `slider_max` integer — Maximum quality slider value
        - `has_modifiers` boolean — Whether this aspect has any modifiers
        - `has_dynamic_modifiers` boolean — Whether modifiers change with quality
        - `is_selected` boolean — Whether this aspect is selected by default
      - `aspect_groups` BlueprintAspectGroup[] — Groups of related aspects
        - `key` string — Internal key of the aspect group
        - `name` string — Display name of the aspect group
        - `display_name` string, nullable — User-facing display name, null if generic
        - `required_count` integer — Number of aspects that must be selected
        - `option_count` integer — Total number of aspect options
        - `is_choice_group` boolean — Whether this is a choice group (required < options)
        - `selected_count` integer — Number of aspects selected by default
        - `aspect_indexes` integer[] — Indexes into the aspects array for this group
      - `has_interactive_aspects` boolean — Whether any aspect has dynamic quality modifiers
    - `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
          - `value_range_type` 'linear', nullable — Interpolation type for the modifier value range. When present, value_segments should be used for interpolation instead of the simple quality_range/modifier_range pair.
          - `value_segments` object[], nullable — Multi-step interpolation segments. Each segment defines its own quality range and modifier start/end values. When present, use these for interpolation instead of quality_range/modifier_range.
            - `quality_min` integer — Start quality for this segment
            - `quality_max` integer — End quality for this segment
            - `modifier_at_start` number, float — Modifier value at quality_min
            - `modifier_at_end` number, float — Modifier value at quality_max
        - `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
  - `links` PaginationLinks — Pagination navigation links.
    - `first` string, nullable — URL to the first page.
    - `last` string, nullable — URL to the last page.
    - `prev` string, nullable — URL to the previous page.
    - `next` string, nullable — URL to the next page.
  - `meta` PaginationMeta — Pagination metadata.
    - `current_page` integer — Current page number.
    - `from` integer — Index of the first item in this page.
    - `last_page` integer — Last available page number.
    - `per_page` integer — Number of items per page.
    - `to` integer — Index of the last item in this page.
    - `total` integer — Total number of items across all pages.
    - `links` object[] — Pagination navigation links with page URLs.
      - `url` string, nullable
      - `label` string
      - `active` boolean
    - `path` string — Base URL path for pagination.

---

[API](https://skmtc.net/starcitizenwiki/apis/star-citizen-wiki-api.md) · [All operations](https://skmtc.net/starcitizenwiki/apis/star-citizen-wiki-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starcitizenwiki/star-citizen-wiki-api/versions/8b259bb9a44c/schema)