---
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.

---

[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)