Sign in
In-Game
Items

In-Game Item Overview

Returns paginated in-game items for the requested category and game version. Always includes manufacturer, game version, and description data. Crafting blueprints are loaded automatically. Supports filtering by type, classification, manufacturer, size, grade, and more. Available includes: shops, variants, related_items, blueprints, shops.items. Supports 150+ JSON field sorts. (see GET /api/items/filters for valid filter values)

get/api/items

Query parameters

pageinteger

Page number for pagination (starts at 1).

page[number]integer

Page number for pagination (starts at 1).

page[size]integer

Number of results to return per page.

includestring

Comma-separated list of relationships to include (e.g. manufacturer,translations).

versionstring

Game version to get data from, if omitted uses default version.

sortstring
Example:-weapon.damage.alpha_total

Sort field. Prefix with "-" for descending. Supports 250+ JSON fields. Examples: name, -grade, weapon.damage.alpha_total, -shield_controller.face_type. Use comma for multiple: grade,-name

filter[variants]boolean
Example:true

When false, excludes variant items (base_id IS NOT NULL) and returns only base items. When true or omitted, returns all items including variants.

filter[category]string
Example:weapons

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

filter[type]string
Example:WeaponPersonal

Exact match on item type. Accepts comma-separated values for OR matching. (see GET /api/items/filters for valid values)

filter[sub_type]string
Example:Barrel

Exact match on item sub-type. Accepts comma-separated values for OR matching. (see GET /api/items/filters for valid values)

filter[manufacturer]string
Example:KnightBridge Arms

Manufacturer name or code. Accepts comma-separated values for OR matching. (see GET /api/items/filters for valid values)

filter[manufacturer.name]string
Example:Anvil Aerospace

Same as filter[manufacturer]. Accepts comma-separated values for OR matching.

filter[class_name]string
Example:MGA_Assault

Partial match on item class name.

filter[name]string
Example:Arrow

Partial match on item display name.

filter[query]string
Example:Arrow

Search items by name or class name.

filter[classification]string
Example:FPS.Armor.Torso

Partial match on item classification (dot-notation, e.g. FPS.Armor). (see GET /api/items/filters for valid values)

filter[size]number
Example:3

Exact item size (0–12).

filter[grade]number
Example:3

Exact item grade (1–7, mapped to A–G).

filter[class]string
Example:Military

Exact match on item class. Accepts comma-separated values for OR matching. (see GET /api/items/filters for valid values)

filter[rarity]string
Example:Rare

Item rarity. Accepts comma-separated values for OR matching. (see GET /api/items/filters for valid values)

Response

List of Items

uuidstring
namestring
class_namestring
classificationstring

Not actually found in the game data, but generated by ScDataDumper.

classification_labelstring nullable

Human-readable label for the item classification

sizeinteger nullable

AttachDef@Size

massnumber double nullable

Generated from SEntityRigidPhysicsControllerParams

rarity'Common' | 'Uncommon' | 'Rare' | 'Epic' | 'Legendary' nullable

Item rarity from stdItem.Rarity. Only present when the item has rarity data.

is_base_variantboolean
is_craftableboolean
gradestring nullable

Only returned for Ship.* items (derived formatting for ship grades).

classstring nullable

Only returned for Ship.* items.

manufacturer_descriptionstring nullable

Manufacturer set in the description

typestring nullable

AttachDef@Type (NOITEM_ prefix removed)

type_labelstring nullable

Human-readable label for the item type

type_web_urlstring nullable

Web URL for filtering items by type

sub_typestring nullable

AttachDef@SubType

sub_type_labelstring nullable

Human-readable label for the item sub-type

positionstring nullable

Only returned for WeaponAttachment items (non-placeholder). Maps sub_type to a display slot name.

max_mountsinteger nullable

Only returned for turret-like items.

max_missilesinteger nullable

Only returned for MissileLauncher turret-like items.

max_bombsinteger nullable

Only returned for BombLauncher turret-like items.

min_sizeinteger nullable

Only returned for turret-like items.

max_sizeinteger nullable

Only returned for turret-like items.

tagsstring[] nullable

AttachDef@Tags

required_tagsstring[] nullable

AttachDef@RequiredTags

entity_tagsstring[] nullable

Entity tag UUIDs from the database relationship (empty array when not loaded).

interactionsstring[] nullable

Generated from SInteractionPointParams

flashlightWeaponAttachmentFlashlight

Flashlight profiles keyed by beam type (narrow, wide) when present.

shopsobject[] nullable

Deprecated: shop data is not available in the source files anymore.

web_urlstring

Web URL for item detail page

linkstring

API URL for item detail endpoint

updated_atstring date-time

Date/time this item was updated in the database.

versionstring

Game version code

Changes