---
title: "In-Game Vehicles Overview"
method: GET
path: "/api/vehicles"
tags: ["In-Game", "Vehicles"]
---

# In-Game Vehicles Overview

`GET /api/vehicles`

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.

## Query parameters

- `page` integer
- `page[number]` integer
- `page[size]` integer
- `include` string
- `version` string
- `sort` string
- `filter[manufacturer]` string
- `filter[manufacturer.name]` string
- `filter[class_name]` string
- `filter[name]` string
- `filter[query]` string
- `filter[size]` integer
- `filter[size_class]` integer
- `filter[career]` string
- `filter[role]` string
- `filter[is_vehicle]` boolean
- `filter[is_gravlev]` boolean
- `filter[is_spaceship]` boolean
- `filter[mass_total]` number
- `filter[cargo_capacity]` number
- `filter[vehicle_inventory]` number
- `filter[crew.min]` integer
- `filter[health]` number
- `filter[shield.hp]` number
- `filter[shield.face_type]` string
- `filter[speed.scm]` number
- `filter[speed.max]` number
- `filter[armor.health]` number
- `filter[cross section.length]` number
- `filter[cross section.width]` number
- `filter[cross section.height]` number
- `filter[signature.ir_quantum]` number
- `filter[signature.ir_shields]` number
- `filter[signature.em_quantum]` number
- `filter[signature.em_shields]` number

## Response `200`

List of Vehicles

- GameVehicle[]
  - `uuid` string — Unique vehicle identifier.
  - `name` string — Display name of the vehicle.
  - `game_name` string, nullable — Internal game class name.
  - `slug` string — URL-friendly vehicle identifier.
  - `class_name` string — class name.
  - `manufacturer` ManufacturerLink
    - `name` string
    - `code` string
    - `uuid` string
    - `link` string
  - `size_class` integer, nullable — Vehicle size classification (1–6).
  - `dimension` object — Vehicle physical dimensions in meters.
    - `length` number — Length in meters.
    - `width` number — Width (beam) in meters.
    - `height` number — Height in meters.
  - `sizes` object — Deprecated, use dimension instead.
    - `length` number
    - `beam` number
    - `height` number
  - `emission` object, nullable — Deprecated, use signature instead. Emission.ir currently maps to IR with shields active. Emission.em_max maps to EM Signature with quantum drive active. Emission.em_idle maps to EM Signature with shields active.
    - `ir` number, nullable
    - `em_idle` number, nullable
    - `em_max` number, nullable
  - `mass` number, nullable — Deprecated, use mass_total instead. Mass is equal to mass_hull.
  - `mass_hull` number, nullable — Hull mass without loadout in kg.
  - `mass_loadout` number, nullable — Equipped loadout mass in kg.
  - `mass_total` number, nullable — Total mass (hull + loadout) in kg.
  - `cargo_capacity` number, nullable — Cargo capacity in SCU.
  - `cargo_grids` ItemInventory[], nullable — Cargo grid containers from ship data.
    - `uuid` string, nullable — Value of containerParams
    - `width` number, double, nullable — interiorDimensions@x
    - `height` number, double, nullable — interiorDimensions@z
    - `length` number, double, nullable — interiorDimensions@y
    - `volume` number, double, nullable — x*y*z
    - `scu` number, double, nullable — Amount of SCU this container can hold. This is the raw value as set in the game data.
    - `scu_converted` number, double, nullable — Raw SCU value (for example µSCU) converted to SCU
    - `unit` string, nullable — Unit as shown in the UI for example µSCU
    - `micro_scu` number, double, nullable — µSCU version of SCU. Only calculated when unit is 0.
    - `open` boolean, nullable — IsOpenContainer
    - `external` boolean, nullable — IsExternalContainer
    - `closed` boolean, nullable — IsClosedContainer
  - `cargo_limits` object, nullable — Calculated cargo size limits based on grid dimensions.
    - `min` object, nullable
      - `x` number, nullable
      - `y` number, nullable
      - `z` number, nullable
    - `max` object, nullable
      - `x` number, nullable
      - `y` number, nullable
      - `z` number, nullable
  - `vehicle_inventory` number, nullable — Vehicle stowage in micro SCU
  - `inventory_containers` ItemInventory[], nullable — Personal inventory containers (stowage) from ship data.
    - `uuid` string, nullable — Value of containerParams
    - `width` number, double, nullable — interiorDimensions@x
    - `height` number, double, nullable — interiorDimensions@z
    - `length` number, double, nullable — interiorDimensions@y
    - `volume` number, double, nullable — x*y*z
    - `scu` number, double, nullable — Amount of SCU this container can hold. This is the raw value as set in the game data.
    - `scu_converted` number, double, nullable — Raw SCU value (for example µSCU) converted to SCU
    - `unit` string, nullable — Unit as shown in the UI for example µSCU
    - `micro_scu` number, double, nullable — µSCU version of SCU. Only calculated when unit is 0.
    - `open` boolean, nullable — IsOpenContainer
    - `external` boolean, nullable — IsExternalContainer
    - `closed` boolean, nullable — IsClosedContainer
  - `crew` object, nullable — Crew requirements.
    - `min` integer, nullable — Minimum crew required to operate.
    - `max` integer, nullable — Maximum crew capacity.
    - `weapon` integer, nullable — Number of weapon crew stations.
    - `operation` integer, nullable — Number of operational crew stations.
  - `is_vehicle` boolean, nullable
  - `is_gravlev` boolean, nullable
  - `is_spaceship` boolean, nullable
  - `health` number, nullable — Total vehicle health pool.
  - `shield_hp` number, nullable — Use shield.hp property instead.
  - `shield_face_type` string, nullable — Use shield.face_type property instead.
  - `shield` object, nullable — Shield system data from scunpacked.
    - `hp` number, nullable — Total shield hit points.
    - `regeneration` number, nullable — Shield regeneration rate per second.
    - `face_type` string, nullable — Shield face configuration (e.g., Bubble, Quadrant).
    - `max_reallocation` number, nullable — Maximum shield reallocation ratio (0–1).
    - `reconfiguration_cooldown` number, nullable — Cooldown time for shield reconfiguration in seconds.
    - `max_electrical_charge_damage_rate` number, nullable — Maximum electrical charge damage rate.
  - `weapon_snapshot` object, nullable — Computed weapon statistics from vehicle loadout
    - `pilot_guns_count` integer
    - `turrets_manned_count` integer
    - `turrets_remote_count` integer
    - `turret_weapon_guns_count` integer
    - `missile_rack_count` integer
    - `missile_count` integer
    - `countermeasures_count` integer
  - `speed` object, nullable — Flight speed characteristics in m/s.
    - `scm` number — Space Combat Maneuvering speed in m/s.
    - `max` number — Maximum speed in m/s.
    - `boost_forward` number, nullable — Forward boost speed in m/s.
    - `boost_backward` number, nullable — Backward boost speed in m/s.
    - `zero_to_scm` number, nullable — Time from zero to SCM speed in seconds.
    - `zero_to_max` number, nullable — Time from zero to max speed in seconds.
    - `scm_to_zero` number, nullable — Time from SCM to zero in seconds.
    - `max_to_zero` number, nullable — Time from max to zero in seconds.
  - `agility` object, nullable — Angular rates and acceleration characteristics.
    - `pitch` number, nullable — Pitch angular rate in deg/s.
    - `yaw` number, nullable — Yaw angular rate in deg/s.
    - `roll` number, nullable — Roll angular rate in deg/s.
    - `pitch_boosted` number, nullable — Pitch angular rate with boost in deg/s.
    - `yaw_boosted` number, nullable — Yaw angular rate with boost in deg/s.
    - `roll_boosted` number, nullable — Roll angular rate with boost in deg/s.
    - `acceleration` object — Linear acceleration values.
      - `main` number, nullable — Forward acceleration in m/s².
      - `retro` number, nullable — Retro (backward) acceleration in m/s².
      - `vtol` number, nullable — VTOL acceleration in m/s².
      - `maneuvering` number, nullable — Maneuvering thruster acceleration in m/s².
      - `main_g` number, nullable — Forward acceleration in G.
      - `retro_g` number, nullable — Retro acceleration in G.
      - `vtol_g` number, nullable — VTOL acceleration in G.
      - `maneuvering_g` number, nullable — Maneuvering acceleration in G.
  - `afterburner` object, nullable — Afterburner properties from FlightCharacteristics.Afterburner.
    - `pitch_boost_multiplier` number, nullable — Pitch angular acceleration multiplier when boosting.
    - `roll_boost_multiplier` number, nullable — Roll angular acceleration multiplier when boosting.
    - `yaw_boost_multiplier` number, nullable — Yaw angular acceleration multiplier when boosting.
    - `capacitor` number, nullable — Maximum afterburner capacitor capacity.
    - `idle_cost` number, nullable — Afterburner capacitor idle drain per second.
    - `linear_cost` number, nullable — Afterburner capacitor cost for linear thrust.
    - `angular_cost` number, nullable — Afterburner capacitor cost for angular thrust.
    - `regen_per_second` number, nullable — Capacitor regeneration per second.
    - `regen_delay_after_use` number, nullable — Delay before regeneration starts after use in seconds.
    - `pre_delay_time` number, nullable — Pre-delay time before afterburner engages in seconds.
    - `ramp_up_time` number, nullable — Ramp-up time to full afterburner in seconds.
    - `ramp_down_time` number, nullable — Ramp-down time from afterburner in seconds.
    - `regen_time` number, nullable — Total time to fully regenerate capacitor in seconds.
    - `regen_delay` number, nullable — Delay before capacitor regeneration in seconds.
  - `fuel` object, nullable — Hydrogen fuel capacity, intake rate, and usage.
    - `capacity` number — Total hydrogen fuel capacity.
    - `intake_rate` number, nullable — Fuel intake rate from scoops.
    - `usage` object, nullable — Fuel consumption rates by thruster type.
      - `main` number, nullable — Main engine fuel consumption rate.
      - `retro` number, nullable — Retro thruster fuel consumption rate.
      - `vtol` number, nullable — VTOL fuel consumption rate.
      - `maneuvering` number, nullable — Maneuvering thruster fuel consumption rate.
  - `quantum` object, nullable — Quantum travel system parameters.
    - `quantum_speed` number, nullable — Quantum travel speed in m/s.
    - `quantum_spool_time` number, nullable — Quantum drive spool-up time in seconds.
    - `quantum_fuel_capacity` number, nullable — Quantum fuel capacity.
    - `quantum_range` number, nullable — Maximum quantum travel range in meters.
    - `port_olisar_to_arccorp_time` number, nullable — Reference travel time from Port Olisar to ArcCorp in seconds.
    - `port_olisar_to_arccorp_fuel` number, nullable — Reference fuel usage from Port Olisar to ArcCorp.
  - `armor` object, nullable — Vehicle armor, damage multipliers, and resistance data.
    - `uuid` string, nullable — Armor item UUID.
    - `health` number, nullable — Armor health pool.
    - `signal_infrared` number, nullable — Infrared signal multiplier (top-level, use signal_multipliers instead).
    - `signal_electromagnetic` number, nullable — Electromagnetic signal multiplier (top-level, use signal_multipliers instead).
    - `signal_cross_section` number, nullable — Cross-section signal multiplier (top-level, use signal_multipliers instead).
    - `damage_physical` number, nullable — Physical damage multiplier (top-level, use damage_multipliers instead).
    - `damage_energy` number, nullable — Energy damage multiplier (top-level, use damage_multipliers instead).
    - `damage_distortion` number, nullable — Distortion damage multiplier (top-level, use damage_multipliers instead).
    - `damage_thermal` number, nullable — Thermal damage multiplier (top-level, use damage_multipliers instead).
    - `damage_biochemical` number, nullable — Biochemical damage multiplier (top-level, use damage_multipliers instead).
    - `damage_stun` number, nullable — Stun damage multiplier (top-level, use damage_multipliers instead).
    - `signal_multipliers` object, nullable — Signal multipliers by type.
      - `cross_section` number, nullable — Cross-section signal multiplier.
      - `infrared` number, nullable — Infrared signal multiplier.
      - `electromagnetic` number, nullable — Electromagnetic signal multiplier.
    - `damage_multipliers` object, nullable — Damage multipliers by type.
      - `physical` number, nullable — Physical damage multiplier.
      - `energy` number, nullable — Energy damage multiplier.
      - `distortion` number, nullable — Distortion damage multiplier.
      - `thermal` number, nullable — Thermal damage multiplier.
      - `biochemical` number, nullable — Biochemical damage multiplier.
      - `stun` number, nullable — Stun damage multiplier.
    - `resistance_multipliers` object, nullable — Resistance multipliers by damage type.
      - `physical` number, nullable — Physical resistance multiplier.
      - `energy` number, nullable — Energy resistance multiplier.
      - `distortion` number, nullable — Distortion resistance multiplier.
      - `thermal` number, nullable — Thermal resistance multiplier.
      - `biochemical` number, nullable — Biochemical resistance multiplier.
      - `stun` number, nullable — Stun resistance multiplier.
    - `penetration_resistance` object, nullable — Penetration resistance values by damage type.
      - `base` number, nullable — Base penetration resistance.
      - `physical` number, nullable — Physical penetration resistance.
      - `energy` number, nullable — Energy penetration resistance.
      - `distortion` number, nullable — Distortion penetration resistance.
      - `thermal` number, nullable — Thermal penetration resistance.
      - `biochemical` number, nullable — Biochemical penetration resistance.
      - `stun` number, nullable — Stun penetration resistance.
  - `insurance` object, nullable — Insurance claim times and expedite costs.
    - `claim_time` number, nullable — Standard claim time in minutes.
    - `expedite_time` number, nullable — Expedited claim time in minutes.
    - `expedite_cost` number, nullable — Cost to expedite the claim in aUEC.
  - `damage_limits` object, nullable
    - `before_destruction` object, nullable — Map of part name => damage capacity before destruction.
    - `before_detach` object, nullable — Map of part name => damage before detachment.
  - `ports` GameVehiclePort[], nullable — Equipment ports from ship loadout. Only included on show route, excluded from index route.
    - `name` string — Hardpoint name from scunpacked ship data.
    - `position` string, nullable — Positional label (e.g. left, right, nose).
    - `sizes` object, nullable — Minimum and maximum item sizes the port accepts.
      - `min` integer, nullable — Minimum item size.
      - `max` integer, nullable — Maximum item size.
    - `class_name` string, nullable — SC class name of the port component.
    - `health` number, nullable — Port health points.
    - `editable` boolean, nullable — Whether the port can be modified in-game.
    - `editable_children` boolean, nullable — Whether child ports can be modified in-game.
    - `equipped_item_uuid` string, nullable — UUID of the item currently equipped in this port.
    - `type` string, nullable — Port type (e.g. WeaponGun, Shield, PowerPlant).
    - `subtype` string, nullable — Port sub-type identifier.
    - `category_label` string, nullable — Human-readable category label. Only present on parent ports (e.g. Weapons, Shields, Thrusters).
    - `compatible_types` object[], nullable — Port compatibility list from ship data.
      - `type` string, nullable — Compatible item type.
      - `sub_types` string[], nullable — List of compatible sub-types for this port type.
    - `equipped_item` GamePortItem — Aggregated related information for base/variants and set items
      - `set_name` string, nullable
      - `base_item` ItemRelatedLink — Link information for a related item with full classification
        - `uuid` string
        - `name` string
        - `class_name` string, nullable
        - `type` string, nullable
        - `type_label` string, nullable — Human-readable label for the item type
        - `sub_type` string, nullable
        - `sub_type_label` string, nullable — Human-readable label for the item sub-type
        - `classification` string, nullable
        - `classification_label` string, nullable — Human-readable label for the item classification
        - `is_base_variant` boolean
        - `variant_name` string, nullable
        - `manufacturer` object, nullable — Manufacturer information with link
          - `code` string, nullable
          - `name` string, nullable
          - `link` string
        - `version` string, nullable
        - `link` string
        - `web_url` string
        - `size` integer, nullable
      - `variant_items` ItemRelatedLink[], nullable
        - `uuid` string
        - `name` string
        - `class_name` string, nullable
        - `type` string, nullable
        - `type_label` string, nullable — Human-readable label for the item type
        - `sub_type` string, nullable
        - `sub_type_label` string, nullable — Human-readable label for the item sub-type
        - `classification` string, nullable
        - `classification_label` string, nullable — Human-readable label for the item classification
        - `is_base_variant` boolean
        - `variant_name` string, nullable
        - `manufacturer` object, nullable — Manufacturer information with link
          - `code` string, nullable
          - `name` string, nullable
          - `link` string
        - `version` string, nullable
        - `link` string
        - `web_url` string
        - `size` integer, nullable
      - `set_items` ItemRelatedLinkExt[], nullable
        - `uuid` string
        - `name` string
        - `class_name` string, nullable
        - `type` string, nullable
        - `type_label` string, nullable — Human-readable label for the item type
        - `sub_type` string, nullable
        - `sub_type_label` string, nullable — Human-readable label for the item sub-type
        - `classification` string, nullable
        - `classification_label` string, nullable — Human-readable label for the item classification
        - `is_base_variant` boolean
        - `variant_name` string, nullable
        - `manufacturer` object, nullable — Manufacturer information with link
          - `code` string, nullable
          - `name` string, nullable
          - `link` string
        - `version` string, nullable
        - `link` string
        - `web_url` string
        - `size` integer, nullable
      - `uuid` string
      - `name` string
      - `class_name` string
      - `type` string, nullable — AttachDef@Type (NOITEM_ prefix removed)
      - `type_label` string, nullable — Human-readable label for the item type
      - `sub_type` string, nullable — AttachDef@SubType
      - `sub_type_label` string, nullable — Human-readable label for the item sub-type
      - `link` string — API URL for item detail endpoint
      - `size` integer, nullable — AttachDef@Size
      - `mass` number, double, nullable — Generated from SEntityRigidPhysicsControllerParams
      - `grade` string, nullable — Derived formatting for ship grades (A, B, C, D) or extracted from DescriptionData.Grade
      - `class` string, nullable — From DescriptionData.Class if not set directly
      - `manufacturer` ManufacturerLink
        - `name` string
        - `code` string
        - `uuid` string
        - `link` string
      - `resource_network` ResourceNetwork — Networked resource behaviour for an item, including power/fuel consumption, generation, and priority.
        - `is_networked` boolean, nullable — Whether the item participates in the ship/station resource network.
        - `is_relay` boolean, nullable — True when the item acts as a relay node.
        - `default_priority` integer, nullable — Processing priority within the network (higher runs earlier). Commonly 50; fuel tanks use 100.
        - `states` ResourceNetworkState[], nullable — List of available network states and their resource deltas.
          - `name` string, nullable — State name (e.g. Online). Can be empty on some items.
          - `signature` object, nullable — Electromagnetic/infrared signature while in this state.
            - `em` number, double, nullable
            - `ir` number, double, nullable
          - `deltas` ResourceNetworkDelta[], nullable
            - `type` string, nullable — Delta type (Consumption, Generation, Conversion, Storage, NetworkReflection).
            - `resource` string, nullable — Target resource affected (Power, Fuel, Coolant, QuantumFuel, Shield, LifeSupport).
            - `rate` number, double, nullable — Rate applied per tick (game native units). Typical power draw ~2–5; fuel draw often 0.01.
            - `minimum_fraction` number, double, nullable — Minimum fraction of the resource that must be available before the delta applies.
            - `generated_resource` string, nullable — Resource produced by conversion/storage deltas.
            - `generated_rate` number, double, nullable — Rate of the generated resource.
            - `discharge` number, double, nullable — Whether stored resource is discharged (0/1 flag).
            - `no_over_generation` number, double, nullable — Prevents generating above capacity (0/1 flag).
            - `binary_evaluation` number, double, nullable — Binary reflection value for NetworkReflection deltas.
            - `composition` object[], nullable — Optional composition entries describing how generated resource is assembled.
              - …
          - `power_ranges` object[], nullable — Power range modifiers applied when this state is active.
            - `start` number, double, nullable — Start value of the power range.
            - `modifier` number, double, nullable — Modifier applied within this power range.
            - `register_range` boolean, nullable — Whether this range should be registered.
        - `repair` object, nullable — Repair configuration for this networked item.
          - `max_repair_count` integer, nullable — Maximum number of repairs allowed.
          - `time_to_repair` number, double, nullable — Time required to perform a repair (seconds).
          - `health_ratio` number, double, nullable — Health ratio threshold for repair eligibility.
        - `usage` object, nullable — Resource usage configuration defining minimum and maximum consumption rates.
          - `power` object, nullable — Power usage range.
            - `minimum` number, double, nullable — Minimum power usage (game units, typically 2-5).
            - `maximum` number, double, nullable — Maximum power usage (game units, typically 2-5).
          - `coolant` object, nullable — Coolant usage range.
            - `minimum` number, double, nullable — Minimum coolant usage.
            - `maximum` number, double, nullable — Maximum coolant usage.
        - `generation` object, nullable — Resource generation configuration defining production rates.
          - `coolant` number, double, nullable — Coolant generation rate.
          - `power` number, double, nullable — Power generation rate.
      - `emission` ItemEmission — EM and IR Emission calculated from Resource Network
        - `ir` number, double, nullable — IR emission
        - `em_min` number, double, nullable — Minimum EM emission
        - `em_max` number, double, nullable — Maximum EM emission
        - `em_decay` number, double, nullable — EM decay
        - `em_per_segment` number, double, nullable — EM decay per segment
      - `version` string — Game version code
    - `ports` GameVehiclePort[], nullable — Nested child ports (hardpoints).
  - `hardpoints` GameVehicleHardpoint[], nullable — Legacy v2 equipment hardpoints from ship loadout. Only included on show route via legacy v2 API, excluded from index route. Use `ports` in current API.
    - `name` string — Hardpoint name from scunpacked data.
    - `position` string, nullable — Positional label (e.g. left, right, nose).
    - `min_size` integer, nullable — Minimum item size the port accepts.
    - `max_size` integer, nullable — Maximum item size the port accepts.
    - `class_name` string, nullable — SC class name of the port component.
    - `health` number, nullable — Port health points.
    - `type` string, nullable — Port type (e.g. WeaponGun, Shield, PowerPlant).
    - `sub_type` string, nullable — Port sub-type identifier.
    - `item` GameVehicleHardpointItem — Aggregated related information for base/variants and set items
      - `uuid` string — Unique item identifier.
      - `name` string — Display name of the equipped item.
      - `class_name` string — SC item class name (e.g. BEHR_LaserCannon_S4).
      - `link` string — API URL for the full item detail.
      - `size` integer, nullable — Item size as integer.
      - `mass` number, double, nullable — Item mass in kg.
      - `grade` string, nullable — Item grade letter (A–D).
      - `class` string, nullable — Item class name from game data.
      - `manufacturer` ManufacturerLink
        - `name` string
        - `code` string
        - `uuid` string
        - `link` string
      - `type` string, nullable — Item type with NOITEM_ prefix stripped.
      - `type_label` string, nullable — Human-readable label for the item type.
      - `sub_type` string, nullable — Item sub-type identifier.
      - `sub_type_label` string, nullable — Human-readable label for the item sub-type.
      - `inventory` ItemInventory — Container (Inventory) of an item, resolved from SCItemInventoryContainerComponentParams
        - `uuid` string, nullable — Value of containerParams
        - `width` number, double, nullable — interiorDimensions@x
        - `height` number, double, nullable — interiorDimensions@z
        - `length` number, double, nullable — interiorDimensions@y
        - `volume` number, double, nullable — x*y*z
        - `scu` number, double, nullable — Amount of SCU this container can hold. This is the raw value as set in the game data.
        - `scu_converted` number, double, nullable — Raw SCU value (for example µSCU) converted to SCU
        - `unit` string, nullable — Unit as shown in the UI for example µSCU
        - `micro_scu` number, double, nullable — µSCU version of SCU. Only calculated when unit is 0.
        - `open` boolean, nullable — IsOpenContainer
        - `external` boolean, nullable — IsExternalContainer
        - `closed` boolean, nullable — IsClosedContainer
      - `ports` ItemPort[], nullable — Sub-ports available on this item.
        - `name` string
        - `display_name` string, nullable
        - `position` string, nullable
        - `size` integer, nullable
        - `sizes` object
          - `min` integer, nullable
          - `max` integer, nullable
        - `compatible_types` ItemPortType[], nullable
          - `type` string, nullable
          - `sub_types` string[], nullable
        - `types` string[], nullable — Raw type strings as provided by the game data
        - `tags` string[], nullable
        - `required_tags` string[], nullable
        - `flags` string[], nullable — Port flags from game data
        - `uneditable` boolean, nullable — Whether the port is locked
        - `equipped_item_uuid` string, nullable — UUID of the equipped item
        - `equipped_item` ItemLink — Information about version and update date
          - `uuid` string
          - `name` string
          - `class_name` string
          - `type` string
          - `type_label` string, nullable — Human-readable label for the item type
          - `sub_type` string, nullable
          - `sub_type_label` string, nullable — Human-readable label for the item sub-type
          - `classification` string, nullable
          - `classification_label` string, nullable — Human-readable label for the item classification
          - `is_base_variant` boolean
          - `variant_name` string, nullable — Extracted variant name, e.g. "Executive Edition" or "Aqua"
          - `manufacturer` ManufacturerLink
            - `name` string
            - `code` string
            - `uuid` string
            - `link` string
          - `link` string
          - `size` integer, nullable
          - `base_variant` string, nullable — Link to base variant item
          - `variants` ItemLink[], nullable
          - `updated_at` string, date-time — Timestamp this data was last updated.
          - `version` string — The Game Version this item exists in.
          - `deprecated_fields` string — Deprecated fields that will be removed in future versions.
        - `equipped_port_item` GamePortItem — Aggregated related information for base/variants and set items
          - `set_name` string, nullable
          - `base_item` ItemRelatedLink — Link information for a related item with full classification
            - `uuid` string
            - `name` string
            - `class_name` string, nullable
            - `type` string, nullable
            - `type_label` string, nullable — Human-readable label for the item type
            - `sub_type` string, nullable
            - `sub_type_label` string, nullable — Human-readable label for the item sub-type
            - `classification` string, nullable
            - `classification_label` string, nullable — Human-readable label for the item classification
            - `is_base_variant` boolean
            - `variant_name` string, nullable
            - `manufacturer` object, nullable — Manufacturer information with link
              - …
            - `version` string, nullable
            - `link` string
            - `web_url` string
            - `size` integer, nullable
          - `variant_items` ItemRelatedLink[], nullable
            - `uuid` string
            - `name` string
            - `class_name` string, nullable
            - `type` string, nullable
            - `type_label` string, nullable — Human-readable label for the item type
            - `sub_type` string, nullable
            - `sub_type_label` string, nullable — Human-readable label for the item sub-type
            - `classification` string, nullable
            - `classification_label` string, nullable — Human-readable label for the item classification
            - `is_base_variant` boolean
            - `variant_name` string, nullable
            - `manufacturer` object, nullable — Manufacturer information with link
              - …
            - `version` string, nullable
            - `link` string
            - `web_url` string
            - `size` integer, nullable
          - `set_items` ItemRelatedLinkExt[], nullable
            - `uuid` string
            - `name` string
            - `class_name` string, nullable
            - `type` string, nullable
            - `type_label` string, nullable — Human-readable label for the item type
            - `sub_type` string, nullable
            - `sub_type_label` string, nullable — Human-readable label for the item sub-type
            - `classification` string, nullable
            - `classification_label` string, nullable — Human-readable label for the item classification
            - `is_base_variant` boolean
            - `variant_name` string, nullable
            - `manufacturer` object, nullable — Manufacturer information with link
              - …
            - `version` string, nullable
            - `link` string
            - `web_url` string
            - `size` integer, nullable
          - `uuid` string
          - `name` string
          - `class_name` string
          - `type` string, nullable — AttachDef@Type (NOITEM_ prefix removed)
          - `type_label` string, nullable — Human-readable label for the item type
          - `sub_type` string, nullable — AttachDef@SubType
          - `sub_type_label` string, nullable — Human-readable label for the item sub-type
          - `link` string — API URL for item detail endpoint
          - `size` integer, nullable — AttachDef@Size
          - `mass` number, double, nullable — Generated from SEntityRigidPhysicsControllerParams
          - `grade` string, nullable — Derived formatting for ship grades (A, B, C, D) or extracted from DescriptionData.Grade
          - `class` string, nullable — From DescriptionData.Class if not set directly
          - `manufacturer` ManufacturerLink
            - `name` string
            - `code` string
            - `uuid` string
            - `link` string
          - `resource_network` ResourceNetwork — Networked resource behaviour for an item, including power/fuel consumption, generation, and priority.
            - `is_networked` boolean, nullable — Whether the item participates in the ship/station resource network.
            - `is_relay` boolean, nullable — True when the item acts as a relay node.
            - `default_priority` integer, nullable — Processing priority within the network (higher runs earlier). Commonly 50; fuel tanks use 100.
            - `states` ResourceNetworkState[], nullable — List of available network states and their resource deltas.
              - …
            - `repair` object, nullable — Repair configuration for this networked item.
              - …
            - `usage` object, nullable — Resource usage configuration defining minimum and maximum consumption rates.
              - …
            - `generation` object, nullable — Resource generation configuration defining production rates.
              - …
          - `emission` ItemEmission — EM and IR Emission calculated from Resource Network
            - `ir` number, double, nullable — IR emission
            - `em_min` number, double, nullable — Minimum EM emission
            - `em_max` number, double, nullable — Maximum EM emission
            - `em_decay` number, double, nullable — EM decay
            - `em_per_segment` number, double, nullable — EM decay per segment
          - `version` string — Game version code
      - `updated_at` string, date-time, nullable — Timestamp of the last update.
      - `version` string, nullable — Game version code this item belongs to.
      - `set_name` string, nullable
      - `base_item` ItemRelatedLink — Link information for a related item with full classification
        - `uuid` string
        - `name` string
        - `class_name` string, nullable
        - `type` string, nullable
        - `type_label` string, nullable — Human-readable label for the item type
        - `sub_type` string, nullable
        - `sub_type_label` string, nullable — Human-readable label for the item sub-type
        - `classification` string, nullable
        - `classification_label` string, nullable — Human-readable label for the item classification
        - `is_base_variant` boolean
        - `variant_name` string, nullable
        - `manufacturer` object, nullable — Manufacturer information with link
          - `code` string, nullable
          - `name` string, nullable
          - `link` string
        - `version` string, nullable
        - `link` string
        - `web_url` string
        - `size` integer, nullable
      - `variant_items` ItemRelatedLink[], nullable
        - `uuid` string
        - `name` string
        - `class_name` string, nullable
        - `type` string, nullable
        - `type_label` string, nullable — Human-readable label for the item type
        - `sub_type` string, nullable
        - `sub_type_label` string, nullable — Human-readable label for the item sub-type
        - `classification` string, nullable
        - `classification_label` string, nullable — Human-readable label for the item classification
        - `is_base_variant` boolean
        - `variant_name` string, nullable
        - `manufacturer` object, nullable — Manufacturer information with link
          - `code` string, nullable
          - `name` string, nullable
          - `link` string
        - `version` string, nullable
        - `link` string
        - `web_url` string
        - `size` integer, nullable
      - `set_items` ItemRelatedLinkExt[], nullable
        - `uuid` string
        - `name` string
        - `class_name` string, nullable
        - `type` string, nullable
        - `type_label` string, nullable — Human-readable label for the item type
        - `sub_type` string, nullable
        - `sub_type_label` string, nullable — Human-readable label for the item sub-type
        - `classification` string, nullable
        - `classification_label` string, nullable — Human-readable label for the item classification
        - `is_base_variant` boolean
        - `variant_name` string, nullable
        - `manufacturer` object, nullable — Manufacturer information with link
          - `code` string, nullable
          - `name` string, nullable
          - `link` string
        - `version` string, nullable
        - `link` string
        - `web_url` string
        - `size` integer, nullable
    - `children` GameVehicleHardpoint[], nullable — Nested child hardpoints.
  - `parts` GameVehiclePart[], nullable
    - `name` string — Raw part name from scunpacked data (e.g. LEFT_WING).
    - `display_name` string — Human-readable name with positional suffix (e.g. "Wing (left)").
    - `damage_max` number, nullable — Maximum damage this structural part can absorb.
    - `children` GameVehiclePart[], nullable — Nested child structural parts.
  - `turrets` object, nullable
    - `manned` GameVehicleTurret[], nullable
      - `category` string, nullable — Turret category (manned, remote, pdc).
      - `display_name` string, nullable — Human-readable turret name.
      - `hardpoint_name` string, nullable — Hardpoint name from ship data.
      - `part_name` string, nullable — Vehicle part this turret belongs to.
      - `turret_type` string, nullable — Full turret type string (e.g. TurretBase.MannedTurret).
      - `class_name` string, nullable — SC class name of the turret component.
      - `size` integer, nullable — Turret hardpoint size.
      - `turret` boolean, nullable — Whether this entry is a turret.
      - `gimballed` boolean, nullable — Whether the turret uses gimbal mounting.
      - `fixed` boolean, nullable — Whether the turret is fixed.
      - `mount_count` integer, nullable — Number of weapon mounts on the turret.
      - `weapon_sizes` integer[], nullable — Aggregated weapon sizes across all mounts.
      - `payload_sizes` integer[], nullable — Aggregated payload sizes across all mounts.
      - `payload_types` string[], nullable — Aggregated payload types across all mounts.
      - `payload_class_names` string[], nullable — Aggregated payload class names across all mounts.
      - `mounts` object[], nullable — Individual mount details for the turret.
        - `display_name` string, nullable — Human-readable mount name.
        - `hardpoint_name` string, nullable — Hardpoint name of the mount.
        - `mount_type` string, nullable — Mount type string (e.g. Turret.GunTurret).
        - `class_name` string, nullable — SC class name of the mount component.
        - `size` integer, nullable — Mount hardpoint size.
        - `weapon_sizes` integer[], nullable — Weapon sizes accepted by this mount.
        - `payload_sizes` integer[], nullable — Payload sizes for this mount.
        - `payload_types` string[], nullable — Payload types for this mount.
        - `payload_class_names` string[], nullable — Payload class names equipped on this mount.
    - `remote` GameVehicleTurret[], nullable
      - `category` string, nullable — Turret category (manned, remote, pdc).
      - `display_name` string, nullable — Human-readable turret name.
      - `hardpoint_name` string, nullable — Hardpoint name from ship data.
      - `part_name` string, nullable — Vehicle part this turret belongs to.
      - `turret_type` string, nullable — Full turret type string (e.g. TurretBase.MannedTurret).
      - `class_name` string, nullable — SC class name of the turret component.
      - `size` integer, nullable — Turret hardpoint size.
      - `turret` boolean, nullable — Whether this entry is a turret.
      - `gimballed` boolean, nullable — Whether the turret uses gimbal mounting.
      - `fixed` boolean, nullable — Whether the turret is fixed.
      - `mount_count` integer, nullable — Number of weapon mounts on the turret.
      - `weapon_sizes` integer[], nullable — Aggregated weapon sizes across all mounts.
      - `payload_sizes` integer[], nullable — Aggregated payload sizes across all mounts.
      - `payload_types` string[], nullable — Aggregated payload types across all mounts.
      - `payload_class_names` string[], nullable — Aggregated payload class names across all mounts.
      - `mounts` object[], nullable — Individual mount details for the turret.
        - `display_name` string, nullable — Human-readable mount name.
        - `hardpoint_name` string, nullable — Hardpoint name of the mount.
        - `mount_type` string, nullable — Mount type string (e.g. Turret.GunTurret).
        - `class_name` string, nullable — SC class name of the mount component.
        - `size` integer, nullable — Mount hardpoint size.
        - `weapon_sizes` integer[], nullable — Weapon sizes accepted by this mount.
        - `payload_sizes` integer[], nullable — Payload sizes for this mount.
        - `payload_types` string[], nullable — Payload types for this mount.
        - `payload_class_names` string[], nullable — Payload class names equipped on this mount.
    - `pdc` GameVehicleTurret[], nullable
      - `category` string, nullable — Turret category (manned, remote, pdc).
      - `display_name` string, nullable — Human-readable turret name.
      - `hardpoint_name` string, nullable — Hardpoint name from ship data.
      - `part_name` string, nullable — Vehicle part this turret belongs to.
      - `turret_type` string, nullable — Full turret type string (e.g. TurretBase.MannedTurret).
      - `class_name` string, nullable — SC class name of the turret component.
      - `size` integer, nullable — Turret hardpoint size.
      - `turret` boolean, nullable — Whether this entry is a turret.
      - `gimballed` boolean, nullable — Whether the turret uses gimbal mounting.
      - `fixed` boolean, nullable — Whether the turret is fixed.
      - `mount_count` integer, nullable — Number of weapon mounts on the turret.
      - `weapon_sizes` integer[], nullable — Aggregated weapon sizes across all mounts.
      - `payload_sizes` integer[], nullable — Aggregated payload sizes across all mounts.
      - `payload_types` string[], nullable — Aggregated payload types across all mounts.
      - `payload_class_names` string[], nullable — Aggregated payload class names across all mounts.
      - `mounts` object[], nullable — Individual mount details for the turret.
        - `display_name` string, nullable — Human-readable mount name.
        - `hardpoint_name` string, nullable — Hardpoint name of the mount.
        - `mount_type` string, nullable — Mount type string (e.g. Turret.GunTurret).
        - `class_name` string, nullable — SC class name of the mount component.
        - `size` integer, nullable — Mount hardpoint size.
        - `weapon_sizes` integer[], nullable — Weapon sizes accepted by this mount.
        - `payload_sizes` integer[], nullable — Payload sizes for this mount.
        - `payload_types` string[], nullable — Payload types for this mount.
        - `payload_class_names` string[], nullable — Payload class names equipped on this mount.
  - `cross_section` object, nullable — Vehicle cross-section dimensions from scunpacked.
    - `length` number, nullable — Cross-section length (X axis).
    - `width` number, nullable — Cross-section width (Y axis).
    - `height` number, nullable — Cross-section height (Z axis).
  - `cross_section_max` number, nullable — Derived: maximum cross-section dimension (max of x, y, z)
  - `signature` object, nullable — EM and IR signature data from scunpacked.
    - `ir_quantum` number, nullable — Infrared signature with quantum drive active.
    - `ir_shields` number, nullable — Infrared signature with shields active.
    - `em_quantum` number, nullable — Electromagnetic signature with quantum drive active.
    - `em_shields` number, nullable — Electromagnetic signature with shields active.
    - `em_groups_quantum` number[], nullable — EM signature groups with quantum drive active.
    - `em_groups_shields` number[], nullable — EM signature groups with shields active.
    - `em_segment_groups_quantum` number[], nullable — EM segment groups with quantum drive active.
    - `em_segment_groups_shields` number[], nullable — EM segment groups with shields active.
    - `em_per_segment` number, nullable — EM signature per segment.
  - `cooling` object, nullable — Cooling system segment allocation.
    - `generation_segments` number, nullable — Total cooling generation segments available.
    - `usage_shields_pct` number, nullable — Percentage of cooling used by shields.
    - `usage_quantum_pct` number, nullable — Percentage of cooling used by quantum drive.
    - `used_segments_shields` number, nullable — Cooling segments consumed by shields.
    - `used_segments_quantum` number, nullable — Cooling segments consumed by quantum drive.
    - `used_segments_shields_grouped` number[], nullable — Grouped cooling segments for shields.
    - `used_segments_quantum_grouped` number[], nullable — Grouped cooling segments for quantum drive.
  - `power` object, nullable — Power system segment allocation.
    - `generation_segments` number, nullable — Total power generation segments available.
    - `used_segments_shields` number, nullable — Power segments consumed by shields.
    - `used_segments_quantum` number, nullable — Power segments consumed by quantum drive.
    - `used_segments_grouped` number[], nullable — Grouped power segments consumed.
  - `power_pools` object, nullable — Power pool allocation limits by component type. Size of -1 indicates unlimited pool.
  - `penetration_multiplier` object, nullable — Penetration multiplier values for fuse and components.
    - `fuse` number, nullable — Fuse penetration multiplier.
    - `components` number, nullable — Components penetration multiplier.
  - `career` string, nullable — Primary career classification (see GET /api/vehicles/filters for valid values).
  - `role` string, nullable — Specific role within the career (see GET /api/vehicles/filters for valid values).
  - `web_url` string, nullable
  - `link` string
  - `description` Translation — Translations of an entity
    - `en` string
    - `de` string
    - `zh` string
  - `id` integer, nullable — Ship-Matrix CIG ID
  - `chassis_id` integer, nullable — Ship-Matrix chassis ID
  - `shipmatrix_name` string, nullable — Ship-Matrix vehicle name
  - `foci` Translation[], nullable — Ship-Matrix vehicle foci/roles
    - `en` string
    - `de` string
    - `zh` string
  - `production_status` Translation — Translations of an entity
    - `en` string
    - `de` string
    - `zh` string
  - `production_note` Translation — Translations of an entity
    - `en` string
    - `de` string
    - `zh` string
  - `type` Translation — Translations of an entity
    - `en` string
    - `de` string
    - `zh` string
  - `msrp` number, nullable — Ship-Matrix MSRP in USD
  - `pledge_url` string, nullable — Link to RSI pledge store
  - `loaner` VehicleLoaner[], nullable — Ship-Matrix loaner vehicles
    - `uuid` string, nullable — Unique vehicle identifier.
    - `name` string
    - `slug` string, nullable — URL-friendly vehicle identifier.
    - `link` string
    - `version` string
  - `skus` VehicleSku[], nullable — Ship-Matrix SKUs
    - `title` string
    - `price` integer
    - `available` boolean
    - `imported_at` string, date-time
  - `components` VehicleComponent[], nullable — Ship-Matrix components (only included when ?include=components)
    - `type` string
    - `name` string
    - `mounts` integer
    - `component_size` integer
    - `category` string
    - `size` integer
    - `details` string
    - `quantity` integer
    - `manufacturer` string
    - `component_class` string
  - `uex_prices` object — Vehicle purchase and rental prices from UEX Corp API.
    - `purchase` object[] — Purchase prices from UEX Corp.
      - `terminal_id` integer — UEX terminal ID
      - `terminal_code` string, nullable
      - `terminal_name` string
      - `starmap_location_uuid` string, nullable
      - `price_buy` number, double
      - `game_version` string, nullable — Game version this price applies to, e.g. 4.7.1
      - `date_updated` string, date-time
      - `link` string, nullable — API URL for the starmap location
      - `web_url` string, nullable — Web URL for the starmap location
      - `starmap_location` object, nullable — Expanded starmap location data
        - `name` string
        - `slug` string, nullable
        - `type_name` string, nullable
        - `parent_name` string, nullable
        - `star_system_name` string, nullable
    - `rental` object[] — Rental prices from UEX Corp.
      - `terminal_id` integer — UEX terminal ID
      - `terminal_code` string, nullable
      - `terminal_name` string
      - `starmap_location_uuid` string, nullable
      - `price_rent` number, double
      - `game_version` string, nullable — Game version this price applies to, e.g. 4.7.1
      - `date_updated` string, date-time
      - `link` string, nullable — API URL for the starmap location
      - `web_url` string, nullable — Web URL for the starmap location
      - `starmap_location` object, nullable — Expanded starmap location data
        - `name` string
        - `slug` string, nullable
        - `type_name` string, nullable
        - `parent_name` string, nullable
        - `star_system_name` string, nullable
  - `images` object[], nullable — Images from external sources for this vehicle.
    - `source` string — Image source identifier
    - `thumbnail_url` string, nullable
    - `thumbnail_width` integer, nullable
    - `thumbnail_height` integer, nullable
    - `original_url` string, nullable
    - `original_width` integer, nullable
    - `original_height` integer, nullable
  - `updated_at` string — Timestamp of last data update.
  - `version` string — Game version code this data applies to.

## Changes

- **2026-04-24** `5922fb7266e2` — 3 info
  - added the new optional `query` request parameter `filter[query]`
  - added the optional property `items/loaner/items/slug` to the response with the `200` status
  - added the optional property `items/loaner/items/uuid` to the response with the `200` status
- **2026-04-24** `c096aa819d11` — 4 breaking, 17 warning, 30 info
  - the response property `items/cargo_grids/items/scu` became nullable for the status `200`
  - added `#/components/schemas/translation` to the `items/description` response property `oneOf` list for the response status `200`
  - the `items/description` response's property type changed from `string` to no type for status `200`
  - the `items/inventory_containers` response's property type changed from `object` to `array` for status `200`
  - …47 more
- …earlier changes not shown

[Full history](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/changes/api/vehicles/get.md)

---

[API](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api.md) · [All operations](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/llms.txt) · [OpenAPI document](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/revisions/5cd81baa02cb?raw)
