Sign in
In-Game
Vehicles

In-Game Ground Vehicles Overview

Alias for /api/vehicles scoped to ground vehicles (is_vehicle=true, is_gravlev=false, is_spaceship=false). Returns paginated in-game ground vehicles for the requested game version. Default includes: vehicle, gameVersion, manufacturer, shipMatrixVehicle.loaner, shipMatrixVehicle.skus.

get/api/ground-vehicles

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:-cargo_capacity

Sort field. Prefix with "-" for descending. Examples: name, -size, manufacturer.name, cargo_capacity, -speed.scm, shield.face_type. Use comma for multiple: size,-cargo_capacity

filter[manufacturer]string
Example:Tumbril

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

filter[manufacturer.name]string
Example:Anvil Aerospace

Alias for filter[manufacturer].

filter[class_name]string
Example:NOBI

Partial match on vehicle class name.

filter[name]string
Example:Nova

Partial match on vehicle display name.

filter[query]string
Example:Nova

Search vehicles by name or class name.

filter[size]integer
Example:3

Exact match on vehicle size (1-6).

filter[size_class]integer
Example:3

Alias for filter[size].

filter[career]string
Example:Ground Combat

Partial match on vehicle career. (see GET /api/vehicles/filters for valid values)

filter[role]string
Example:Starter / Light Freight

Partial match on vehicle role. (see GET /api/vehicles/filters for valid values)

filter[is_vehicle]boolean
Example:true

Filter to ground vehicles only.

filter[is_gravlev]boolean
Example:true

Filter to gravlev vehicles only.

filter[is_spaceship]boolean
Example:true

Filter to spaceships only.

filter[mass_total]number
Example:50000

Numeric filter on total mass (kg). Supports range operators.

filter[cargo_capacity]number
Example:46

Numeric filter on cargo capacity (SCU). Supports range operators.

filter[vehicle_inventory]number
Example:432

Numeric filter on vehicle inventory/stowage capacity. Supports range operators.

filter[crew.min]integer
Example:2

Numeric filter on minimum crew count. Supports range operators.

filter[health]number
Example:50000

Numeric filter on vehicle health points. Supports range operators.

filter[shield.hp]number
Example:1000000

Numeric filter on total shield hit points. Supports range operators.

filter[shield.face_type]string
Example:Bubble

Shield face type. (see GET /api/vehicles/filters for valid values)

filter[speed.scm]number
Example:200

Numeric filter on SCM speed. Supports range operators.

filter[speed.max]number
Example:1200

Numeric filter on maximum speed. Supports range operators.

filter[armor.health]number
Example:500000

Numeric filter on armor health points. Supports range operators.

filter[cross section.length]number
Example:100

Numeric filter on cross-section length (X axis). Supports range operators.

filter[cross section.width]number
Example:50

Numeric filter on cross-section width (Y axis). Supports range operators.

filter[cross section.height]number
Example:30

Numeric filter on cross-section height (Z axis). Supports range operators.

filter[signature.ir_quantum]number
Example:100

Numeric filter on infrared quantum signature emission. Supports range operators.

filter[signature.ir_shields]number
Example:100

Numeric filter on infrared shield signature emission. Supports range operators.

filter[signature.em_quantum]number
Example:100

Numeric filter on electromagnetic quantum signature emission. Supports range operators.

filter[signature.em_shields]number
Example:100

Numeric filter on electromagnetic shield signature emission. Supports range operators.

Response

List of Ground Vehicles

uuidstring

Unique vehicle identifier.

namestring

Display name of the vehicle.

game_namestring nullable

Internal game class name.

slugstring

URL-friendly vehicle identifier.

class_namestring

class name.

size_classinteger nullable

Vehicle size classification (1–6).

massnumber nullable

Deprecated, use mass_total instead. Mass is equal to mass_hull.

mass_hullnumber nullable

Hull mass without loadout in kg.

mass_loadoutnumber nullable

Equipped loadout mass in kg.

mass_totalnumber nullable

Total mass (hull + loadout) in kg.

cargo_capacitynumber nullable

Cargo capacity in SCU.

vehicle_inventorynumber nullable

Vehicle stowage in micro SCU

is_vehicleboolean nullable
is_gravlevboolean nullable
is_spaceshipboolean nullable
healthnumber nullable

Total vehicle health pool.

shield_hpnumber nullable

Use shield.hp property instead.

shield_face_typestring nullable

Use shield.face_type property instead.

cross_section_maxnumber nullable

Derived: maximum cross-section dimension (max of x, y, z)

power_poolsobject nullable

Power pool allocation limits by component type. Size of -1 indicates unlimited pool.

careerstring nullable

Primary career classification (see GET /api/vehicles/filters for valid values).

rolestring nullable

Specific role within the career (see GET /api/vehicles/filters for valid values).

web_urlstring nullable
linkstring
idinteger nullable

Ship-Matrix CIG ID

chassis_idinteger nullable

Ship-Matrix chassis ID

shipmatrix_namestring nullable

Ship-Matrix vehicle name

msrpnumber nullable

Ship-Matrix MSRP in USD

pledge_urlstring nullable

Link to RSI pledge store

updated_atstring

Timestamp of last data update.

versionstring

Game version code this data applies to.

Changes