v1

latestOpenAPI 3.0.0MIT (code only)2026-07-1783284693.9 KB

Items

In-Game Item 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.

get/api/items/filters

Query parameters

versionstring

Game version code to scope results to. Omit to use the current default version. Use GET /api/game-versions to list available versions and GET /api/game-versions/default to discover the default.

filter[variants]boolean

When false, facets are computed excluding variant items. When true or omitted, all items are included.

filter[category]string

Item category to scope facets. Accepts: weapons, weapon-attachments, clothes, armor, food, medical, mining-modifiers, fps-items, vehicle-weapons, vehicle-items, vehicle-flair-items, vehicle-components. Example: weapons

filter[type]string

Narrow facets to items matching this type. Example: WeaponPersonal

filter[sub_type]string

Narrow facets to items matching this sub-type. Example: Barrel

filter[manufacturer]string

Narrow facets to items from this manufacturer. Example: KnightBridge Arms

filter[manufacturer.name]string

Same as filter[manufacturer]. Example: Anvil Aerospace

filter[class_name]string

Narrow facets to items with matching class name. Example: MGA_Assault

filter[name]string

Narrow facets to items with matching name. Example: Arrow

filter[query]string

Narrow facets to items matching name or class name. Example: Arrow

filter[classification]string

Narrow facets to items with matching classification. Example: FPS.Armor.Torso

filter[size]number

Narrow facets to items with this size. Example: 3

filter[grade]number

Narrow facets to items with this grade. Example: 3

filter[class]string

Narrow facets to items with this class. Example: Military

filter[rarity]string

Narrow facets to items with this rarity. Example: Rare

filter[event_source]string

Narrow facets to items with this event or reward source. Example: IAE

filter[include_irrelevant]boolean

When set to true, includes items flagged as not player-relevant (test, placeholder, dev items). Default shows only relevant items.

Response

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