Sign in
In-Game
Items
Search

In-Game Item Search (Deprecated)

Deprecated. Use GET /api/items?filter[name]={value} for name search. Note: OR search across name/uuid/type is no longer supported. This endpoint will be removed in a future version.

post/api/items/search

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.

localestring

Locale code for translated fields (e.g. en, de, zh).

includestring

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

sortstring

Comma-separated list of fields to sort by. Prefix with - for descending order (e.g. -name,size).

filter[variants]boolean
Example:true

When false, excludes variant items and returns only base items. When true or omitted, returns all items.

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

Request body

object required

Response

A List of matching Items

uuidstring
slugstring nullable

URL-friendly slug for the item.

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

gforce_resistancenumber double nullable

G-force tolerance modifier. Positive values increase tolerance, negative values reduce it. 0 = neutral.

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