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

Changes

Changed in 26 of the 50 revisions of this API.2657237

    • added the optional property data/items/is_power_suit to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/skus/items/cig_id to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/skus/items/discounted_price to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/skus/items/is_package to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/skus/items/is_warbond to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/skus/items/source to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/skus/items/url to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/description/oneOf[subschema #1: Grouped Translations]/fr to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/foci/items/fr to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/game_description to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/production_note/oneOf[subschema #1: Grouped Translations]/fr to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/production_status/oneOf[subschema #1: Grouped Translations]/fr to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/type/oneOf[subschema #1: Grouped Translations]/fr to the response with the 200 status

      response-optional-property-added

    • added game_port_item_summary to the data/items/ports/items/equipped_item response property oneOf list for the response status 200

      response-property-one-of-added

  • a60af0c650cb1111See the full diff
    • added game_port_item to the data/items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/equipped_item response property oneOf list for the response status 200

      response-property-one-of-added

    • removed the optional property data/items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/equipped_port_item from the response with the 200 status

      response-optional-property-removed

    • added the optional property data/items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/port_tags to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/ports to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/sub_type to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/type to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/no_fuel_params to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/ports/items/equipped_item/oneOf[subschema #1: Equipped Port Item]/allOf[subschema #2]/classification to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/ports/items/equipped_item/oneOf[subschema #1: Equipped Port Item]/allOf[subschema #2]/classification_label to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/ports/items/equipped_item/oneOf[subschema #1: Equipped Port Item]/allOf[subschema #2]/is_base_variant to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/ports/items/equipped_item/oneOf[subschema #1: Equipped Port Item]/allOf[subschema #2]/variant_name to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/ports/items/equipped_item/oneOf[subschema #1: Equipped Port Item]/allOf[subschema #2]/web_url to the response with the 200 status

      response-optional-property-added

    • removed item_link from the data/items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/equipped_item response property oneOf list for the response status 200

      response-property-one-of-removed

    • added the optional property data/items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/equipped_item/oneOf[subschema #1: Item Link]/allOf[subschema #2: Metadata]/resource to the response with the 200 status

      response-optional-property-added

  • af03a6ba771d15See the full diff
    • the response's body type/format changed from array/ to object/ for status 200

      response-body-type-changed

    • api operation id 64acf0fa3be1afd1fa9ee22c03f755bc removed and replaced with listVehicles

      api-operation-id-removed

    • api tag In-Game removed

      api-tag-removed

    • added the optional property data to the response with the 200 status

      response-optional-property-added

    • added the optional property links to the response with the 200 status

      response-optional-property-added

    • added the optional property meta to the response with the 200 status

      response-optional-property-added

    • added the optional property items/shield/regeneration_time to the response with the 200 status

      response-optional-property-added

  • bfe05306de981227See the full diff
    • the response property items/uex_prices/purchase/items/date_updated became nullable for the status 200

      response-property-became-nullable

    • the response property items/uex_prices/purchase/items/price_buy became nullable for the status 200

      response-property-became-nullable

    • the response property items/uex_prices/purchase/items/terminal_id became nullable for the status 200

      response-property-became-nullable

    • the response property items/uex_prices/purchase/items/terminal_name became nullable for the status 200

      response-property-became-nullable

    • the response property items/uex_prices/rental/items/date_updated became nullable for the status 200

      response-property-became-nullable

    • the response property items/uex_prices/rental/items/price_rent became nullable for the status 200

      response-property-became-nullable

    • the response property items/uex_prices/rental/items/terminal_id became nullable for the status 200

      response-property-became-nullable

    • the response property items/uex_prices/rental/items/terminal_name became nullable for the status 200

      response-property-became-nullable

    • the items/uex_prices/purchase/items/date_updated response's property type/format changed from string/date-time to string/ for status 200

      response-property-type-changed

    • the items/uex_prices/purchase/items/price_buy response's property type/format changed from number/double to number/ for status 200

      response-property-type-changed

    • the items/uex_prices/rental/items/date_updated response's property type/format changed from string/date-time to string/ for status 200

      response-property-type-changed

    • the items/uex_prices/rental/items/price_rent response's property type/format changed from number/double to number/ for status 200

      response-property-type-changed

    • removed the optional property items/uex_prices/purchase/items/starmap_location_uuid from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/rental/items/starmap_location_uuid from the response with the 200 status

      response-optional-property-removed

    • added the optional property items/port_tags to the response with the 200 status

      response-optional-property-added

    • added the optional property items/uex_prices/purchase/items/price_rent to the response with the 200 status

      response-optional-property-added

    • added the optional property items/uex_prices/purchase/items/price_sell to the response with the 200 status

      response-optional-property-added

    • added the optional property items/uex_prices/purchase/items/uex_link to the response with the 200 status

      response-optional-property-added

    • added the optional property items/uex_prices/rental/items/price_buy to the response with the 200 status

      response-optional-property-added

    • added the optional property items/uex_prices/rental/items/price_sell to the response with the 200 status

      response-optional-property-added

    • added the optional property items/uex_prices/rental/items/uex_link to the response with the 200 status

      response-optional-property-added

  • da635a661a4c4143See the full diff
    • added starmap_location_link to the items/uex_prices/purchase/items/starmap_location response property oneOf list for the response status 200

      response-property-one-of-added

    • added starmap_location_link to the items/uex_prices/rental/items/starmap_location response property oneOf list for the response status 200

      response-property-one-of-added

    • the items/uex_prices/purchase/items/starmap_location response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • the items/uex_prices/rental/items/starmap_location response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • removed the optional property items/uex_prices/purchase/items/link from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/purchase/items/starmap_location/name from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/purchase/items/starmap_location/parent_name from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/purchase/items/starmap_location/slug from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/purchase/items/starmap_location/star_system_name from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/purchase/items/starmap_location/type_name from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/purchase/items/web_url from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/rental/items/link from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/rental/items/starmap_location/name from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/rental/items/starmap_location/parent_name from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/rental/items/starmap_location/slug from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/rental/items/starmap_location/star_system_name from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/rental/items/starmap_location/type_name from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/uex_prices/rental/items/web_url from the response with the 200 status

      response-optional-property-removed

    • added the optional property items/hardpoints/items/item/oneOf[subschema #1: Vehicle Hardpoint Item v2]/allOf[subschema #1]/ports/items/equipped_item/oneOf[subschema #1: Item Link]/allOf[subschema #1]/web_url to the response with the 200 status

      response-optional-property-added

    • added the optional property items/suit_storage to the response with the 200 status

      response-optional-property-added

    • added the optional property items/weapon_storage to the response with the 200 status

      response-optional-property-added