---
title: "Game Commodity Filters"
method: GET
path: "/api/commodities/filters"
tags: ["Commodities"]
---

# Game Commodity Filters

`GET /api/commodities/filters`

Returns all available filter values for game commodities, scoped to the requested or default game version. Filter values can be combined; providing a system filter will narrow the location facet to that system only.

## Query parameters

- `version` 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`

Available filters for game commodities.

- object
  - `filters` object
    - `system` FilterValue[] — Star systems where commodities can be found
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `type` FilterValue[] — Location type names
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `rarity` FilterValue[] — Commodity tier/rarity levels
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `kind` FilterValue[] — Resource kinds
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `refined_version` FilterValue[] — Refined version names
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `group` FilterValue[] — Commodity groups
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `location` FilterValue[] — Starmap locations grouped by system
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.

## Changes

- **2026-06-05** `740b044d147f` — 7 breaking
  - the response property `filters/group/items/count` became nullable for the status `200`
  - the response property `filters/kind/items/count` became nullable for the status `200`
  - the response property `filters/location/items/count` became nullable for the status `200`
  - the response property `filters/rarity/items/count` became nullable for the status `200`
  - …3 more
- **2026-06-05** `778c43a31df2` — 2 info
  - added the new optional `query` request parameter `filter[group]`
  - added the optional property `filters/group` to the response with the `200` status
- **2026-05-21** `af03a6ba771d` — 2 info
  - api operation id `25f5f4334a61558e17a9b075d08a0a90` removed and replaced with `listCommodityFilters`
  - api tag `In-Game` removed
- **2026-04-23** `01e52e527dd6` — 1 info
  - api operation id `d3f154ced9b209036d996ecf89c73e51` removed and replaced with `25f5f4334a61558e17a9b075d08a0a90`
- **2026-04-14** `f23b7f0f9b18` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/changes/api/commodities/filters/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-service-production.skmtc.workers.dev/v1/apis/starcitizenwiki/star-citizen-wiki-api/revisions/8b259bb9a44c/schema)