---
title: "In-Game Item Filters"
method: GET
path: "/api/items/filters"
tags: ["Items"]
---

# In-Game Item Filters

`GET /api/items/filters`

Returns available filter facet values for in-game items, grouped by field with occurrence counts. Applying other filters narrows the facet results. Use these values as filter[*] parameters on GET /api/items. Scoped to the default item category unless filter[category] is specified.

## Query parameters

- `version` string
- `filter[variants]` boolean
- `filter[category]` string
- `filter[type]` string
- `filter[sub_type]` string
- `filter[manufacturer]` string
- `filter[manufacturer.name]` string
- `filter[class_name]` string
- `filter[name]` string
- `filter[query]` string
- `filter[classification]` string
- `filter[size]` number
- `filter[grade]` number
- `filter[class]` string
- `filter[rarity]` string
- `filter[event_source]` string
- `filter[include_irrelevant]` boolean

## Response `200`

Available filter facets for in-game items, grouped by field with counts.

- object
  - `filters` object
    - `type` FilterValue[] — Item types (e.g. WeaponPersonal, Cooler, Shield)
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `sub_type` FilterValue[] — Item sub-types (e.g. Barrel, Default, Optic)
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `classification` FilterValue[] — Item classifications (e.g. FPS.Armor.Torso, Ship.Cooler)
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `size` FilterValue[] — Item sizes (0-12)
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `grade` FilterValue[] — Item grades (1-7, mapped A-G)
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `class` FilterValue[] — Item classes (Civilian, Competition, Industrial, Military, Stealth)
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `manufacturer` FilterValue[] — Manufacturer names
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `rarity` FilterValue[] — Item rarity levels (Common, Uncommon, Rare, Epic, Legendary)
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.
    - `event_source` FilterValue[] — Event or reward source labels (count-less values)
      - `value` union
        - string
        - integer
        - boolean
      - `label` string
      - `count` integer, nullable — Result count when supplied by the facet.

## Changes

- **2026-06-05** `740b044d147f` — 8 breaking, 2 info
  - the response property `filters/class/items/count` became nullable for the status `200`
  - the response property `filters/classification/items/count` became nullable for the status `200`
  - the response property `filters/grade/items/count` became nullable for the status `200`
  - the response property `filters/manufacturer/items/count` became nullable for the status `200`
  - …6 more
- **2026-05-21** `af03a6ba771d` — 2 info
  - api operation id `8cd032a0b4591c3e203c00e9e5779194` removed and replaced with `listItemFilters`
  - api tag `In-Game` removed
- **2026-05-14** `40f3073395a9` — 1 info
  - added the new optional `query` request parameter `filter[include_irrelevant]`
- **2026-04-25** `3a87c8145779` — 2 info
  - added the new optional `query` request parameter `filter[rarity]`
  - added the optional property `filters/rarity` to the response with the `200` status
- **2026-04-24** `5922fb7266e2` — 1 info
  - added the new optional `query` request parameter `filter[query]`

[Full history](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/changes/api/items/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)