---
title: "List Game Commodities"
method: GET
path: "/api/commodities"
tags: ["Commodities"]
---

# List Game Commodities

`GET /api/commodities`

Returns paginated game commodities with location data and resource metadata, optionally filtered to only those consumed by blueprints. Results include refined version info and starmap location data scoped to the requested or default game version.

## Query parameters

- `page` integer
- `page[number]` integer
- `page[size]` integer
- `version` string
- `sort` string
- `filter[used]` boolean
- `filter[system]` string
- `filter[type]` string
- `filter[rarity]` string
- `filter[kind]` string
- `filter[group]` string
- `filter[refined_version]` string
- `filter[location]` string
- `filter[query]` string
- `filter[ship]` boolean
- `filter[ground_vehicle]` boolean
- `filter[fps]` boolean
- `filter[harvestable]` boolean
- `filter[salvage]` boolean
- `filter[mineable]` boolean

## Response `200`

List of commodities

- object
  - `data` CommodityLink[]
    - `uuid` string, uuid — Unique commodity identifier.
    - `key` string — Internal commodity key (e.g. "Quartz").
    - `name` string — Display name of the commodity.
    - `display_name` string — Name with leaf commodity group in parentheses, e.g. "WiDoW (Vice)".
    - `slug` string — URL-friendly slug for the commodity.
    - `description` string, nullable — In-game lore description.
    - `tier` string, nullable — Refinement tier (e.g. "Raw", "Refined").
    - `refined_version` object, nullable — The refined counterpart of this raw commodity, if applicable.
      - `name` string — Name of the refined commodity.
      - `uuid` string, uuid — UUID of the refined commodity.
      - `web_url` string, uri — Frontend URL for the refined commodity page.
      - `link` string, uri — API link to the refined commodity details.
    - `density_g_per_cc` number, nullable — Density in grams per cubic centimeter.
    - `instability` number, nullable — Instability rating affecting mining behavior.
    - `resistance` number, nullable — Resistance rating affecting mining difficulty.
    - `volatility` number, nullable — Volatility rating for this resource type.
    - `volatility_health_decay_per_second` number, nullable — Health decay per second associated with this resource type volatility.
    - `box_sizes_scu` number[] — Standard cargo box sizes in SCU that this commodity fits into.
    - `validate_default_cargo_box` boolean — Whether the default cargo box validation applies.
    - `has_default_cargo_containers` boolean — Whether default cargo containers are available for this commodity.
    - `is_mineable` boolean — Whether this commodity can be obtained through mining or harvesting.
    - `has_ship_mineables` boolean — Whether ship mining deposits exist for this commodity.
    - `has_ground_vehicle_mineables` boolean — Whether ground vehicle mining deposits exist for this commodity.
    - `has_fps_mineables` boolean — Whether FPS mining deposits exist for this commodity.
    - `has_harvestables` boolean — Whether harvestable deposits exist for this commodity.
    - `has_salvage` boolean — Whether salvage deposits exist for this commodity.
    - `signature` integer, nullable — Electromagnetic signature strength, used for scanner detection.
    - `kind` string, nullable — Resource kind classification (e.g. "Mineable", "Harvestable").
    - `commodity_groups` string[], nullable — Ordered commodity groups from root to leaf (e.g. ["ProcessedGoods", "Vice"]).
    - `methods` string[] — Available extraction methods (e.g. ["Ship", "Ground Vehicle", "FPS"]).
    - `systems` string[] — Star systems where this commodity can be found.
    - `locations` CommodityIndexLocation[] — Named locations where this commodity appears.
      - `name` string — Canonical location name.
      - `display_name` string — Formatted display name including designation prefix (e.g. "CRU-L1: Green Circle").
      - `system` string, nullable — Star system name this location belongs to.
      - `type` string, nullable — Location type classification (e.g. "Moon", "Planet", "Outpost").
      - `parent_name` string, nullable — Name of the parent celestial body or location.
      - `parent_type` string, nullable — Type of the parent location.
      - `uuid` string, uuid, nullable — UUID of the starmap location entity.
      - `link` string, uri, nullable — API link to the full location details.
      - `entries` CommodityIndexLocationEntry[] — Resource entries grouped by mining method.
        - `group_name` string — Internal group name identifying the mining method or category (e.g. "SpaceShip_Mineables", "Harvestables").
        - `resource_kind` string, nullable — Kind of resource if resolvable from the group (e.g. "Mineable", "Harvestable").
        - `quality_min` integer, nullable — Minimum quality value across entries in this group.
        - `quality_max` integer, nullable — Maximum quality value across entries in this group.
        - `entry_count` integer — Number of individual resource entries in this group.
    - `link` string, uri — API link to this commodity's full details.
    - `web_url` string, uri — Frontend URL for this commodity's page.
    - `images` object[] — Images from external sources for this commodity.
      - `source` string — Image source identifier
      - `thumbnail_url` string, nullable
      - `thumbnail_width` integer, nullable
      - `thumbnail_height` integer, nullable
      - `original_url` string, nullable
      - `original_width` integer, nullable
      - `original_height` integer, nullable
  - `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)