v1

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

In-Game Vehicles Overview

Returns paginated in-game vehicles for the requested game version. Default includes: vehicle, gameVersion, manufacturer, shipMatrixVehicle.loaner, shipMatrixVehicle.skus. Optional includes: shipMatrixVehicle, components, shipmatrixvehicle.components, hardpoints, ports.

get/api/vehicles

Query parameters

pageinteger

Page number for pagination (starts at 1). Prefer using page[number] instead.

page[number]integer

Page number for pagination (starts at 1).

page[size]integer

Number of results per page. Maximum 200.

includestring

Comma-separated list of relationships to include. Available includes vary per endpoint, see each endpoint's description for supported values.

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.

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

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

filter[manufacturer.name]string

Alias for filter[manufacturer]. Example: Anvil Aerospace

filter[class_name]string

Partial match on vehicle class name. Example: TMBL_Nova

filter[name]string

Partial match on vehicle display name. Example: Nova

filter[query]string

Search vehicles by name or class name. Example: Carrack

filter[size]integer

Exact match on vehicle size (1-6). Example: 3

filter[size_class]integer

Alias for filter[size]. Example: 3

filter[career]string

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

filter[role]string

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

filter[is_vehicle]boolean

Filter to ground vehicles only.

filter[is_gravlev]boolean

Filter to gravlev vehicles only.

filter[is_spaceship]boolean

Filter to spaceships only.

filter[mass_total]number

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

filter[cargo_capacity]number

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

filter[vehicle_inventory]number

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

filter[crew.min]integer

Numeric filter on minimum crew count. Supports range operators. Example: 2

filter[health]number

Numeric filter on vehicle health points. Supports range operators. Example: 1550

filter[shield.hp]number

Numeric filter on total shield hit points. Supports range operators. Example: 720

filter[shield.face_type]string

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

filter[speed.scm]number

Numeric filter on SCM speed. Supports range operators. Example: 220

filter[speed.max]number

Numeric filter on maximum speed. Supports range operators. Example: 1150

filter[armor.health]number

Numeric filter on armor health points. Supports range operators. Example: 10890

filter[cross section.length]number

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

filter[cross section.width]number

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

filter[cross section.height]number

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

filter[signature.ir_quantum]number

Numeric filter on infrared quantum signature emission. Supports range operators. Example: 10882

filter[signature.ir_shields]number

Numeric filter on infrared shield signature emission. Supports range operators. Example: 10267

filter[signature.em_quantum]number

Numeric filter on electromagnetic quantum signature emission. Supports range operators. Example: 53959

filter[signature.em_shields]number

Numeric filter on electromagnetic shield signature emission. Supports range operators. Example: 17643

Response

List of Vehicles