Vehicle search fields and examples

Pro+ tier

These are the fields of the vehicles search collection behind /search-public/vehicles (GET, POST). Use them in query_by, filter_by and sort_by. The parameters, plan limits, Pro tier filtering, redacted properties and date handling that apply to every collection are described in Search, and the response schema on the endpoint pages.

Field guides for the other collections:

Companies
Workplaces
Bankruptcies
Vehicles (you are here)
Properties

Vehicles search

With our search for vehicles you can query (query_by) based on a number fields listed in the next chapter.

Examples on what you can query on:

Manufacturer
Licence plate
Model
Type

Fields indexed

The following fields are currently indexed in memory. These can be used in the query_by and filter_by parameter.

Field	Type	Description
`fabric`	`string[]`	Fabric name
`vehicleClassDescription`	`string`
`vehicleTypeDescription`	`string`
`fuelCombination`	`string`
`colorHex`	`string`
`color`	`string`
`vehicleClassAndDescription`	`string`
`enginePowerHkAll`	`string[]`
`electricVehicleConfigurationDescription`	`string`
`fuelCodeDescriptions`	`string[]`
`areaOfUse`	`string[]`
`couplings`	`string[]`
`name`	`string`
`gearbox`	`string`
`manufacturingMonthDescription`	`string`
`licencePlate`	`string`
`deregistered`	`int64`
`deregisteredText`	`string`
`deregisteredCause`	`string`
`vehicleType`	`string`
`vehicleCategoryEU`	`string`
`vehicleName`	`string`
`tradeName`	`string`
`modelYear`	`int32`
`vehicleYear`	`int32`
`vin`	`string`
`fabricCode`	`string`
`modelNumber`	`string`
`groupNumber`	`string`
`manufacturingYearAndMonth`	`int32`
`manufactured`	`int64`
`reuseLicencePlate`	`bool`
`registered`	`int64`
`vehicleClass`	`string`
`doodlebug`	`bool`
`manufacturer`	`string`
`manfacturerBasicVehicle`	`string`
`numberOfOwners`	`int32`
`acquiredByOwner`	`int64`
`registrationType`	`string`
`status`	`string`
`statusDate`	`int64`
`statusCause`	`string`
`onLease`	`bool`
`areaOfUse1`	`string`
`areaOfUse2`	`string`
`areaOfUse3`	`string`
`areaOfUse4`	`string`
`areaOfUse5`	`string`
`insuranceType`	`string`
`onCredit`	`bool`
`importer`	`string`
`originCode`	`string`
`originCause`	`string`
`preregistered`	`int64`
`earlierRegistration`	`int64`
`directImport`	`bool`
`variety`	`string`
`version`	`string`
`type`	`string`
`bodyworkCode1`	`string`
`bodyworkCode2`	`string`
`bodyworkCodeAddition`	`string`
`busClass`	`string`
`numberOfPassengers`	`int32`
`numberOfSeats`	`int32`
`eeg`	`string`
`cylinderVolume`	`int32`
`gearbox`	`string`
`coupling1`	`string`
`coupling2`	`string`
`curbWeight`	`int32`
`weightInDrivingCondition`	`int32`
`totalWeight`	`int32`
`fuelCode1`	`string`
`fuelCode2`	`string`
`fuelCode3`	`string`
`enginePowerHk1`	`int32`
`enginePowerHk2`	`int32`
`enginePowerHk3`	`int32`
`enginePowerUnit1`	`string`
`enginePowerUnit2`	`string`
`enginePowerUnit3`	`string`
`fuelCombination`	`string`
`fuelTankSize1`	`int32`
`fuelTankSize2`	`int32`
`fuelTankSize3`	`int32`
`width`	`int32`
`length`	`int32`
`height`	`int32`
`maxTrailerWeightKg`	`int32`
`maxTrailerWeightB`	`int32`
`maxTrailerWeightBExtB`	`int32`
`maxWeightTrailer`	`int32`
`maxWeightUnbreakedTrailer`	`int32`
`maxTrailerSpeed`	`float`
`maxLoadWeight`	`int32`
`fourWheelDrive`	`bool`
`maximumPowerForElectricVehicle`	`float`
`powerDuring30Minutes`	`float`
`powerDuring15Minutes`	`float`
`averagePayload`	`float`
`workVehicle`	`bool`
`environmentalClass`	`string`
`environmentalVehicle`	`string`
`environmentalClassEURO`	`string`
`emissionClass`	`string`
`superEnvironmentalVehicle`	`bool`
`co2Driv1`	`float`
`co2Driv2`	`float`
`co2Driv3`	`float`
`consumption1`	`float`
`consumption2`	`float`
`consumption3`	`float`
`energyConsumption`	`int32`
`soundLevel1`	`int32`
`soundLevel2`	`int32`
`soundLevel3`	`int32`
`consumptionWeightedMixed`	`float`
`co2WeightedMixed`	`float`
`wltp_C02Low1`	`int32`
`wltp_C02Low2`	`int32`
`wltp_C02Low3`	`int32`
`wltp_C02Med1`	`int32`
`wltp_C02Med2`	`int32`
`wltp_C02Med3`	`int32`
`wltp_C02High1`	`int32`
`wltp_C02High2`	`int32`
`wltp_C02High3`	`int32`
`wltp_C02ExtraHigh1`	`int32`
`wltp_C02ExtraHigh2`	`int32`
`wltp_C02ExtraHigh3`	`int32`
`wltp_C02Mixed1`	`int32`
`wltp_C02Mixed2`	`int32`
`wltp_C02Mixed3`	`int32`
`wltp_CO2Weighted1`	`int32`
`wltp_CO2Weighted2`	`int32`
`wltp_CO2Weighted3`	`int32`
`wltp_FuelConsumptionLow1`	`float`
`wltp_FuelConsumptionLow2`	`float`
`wltp_FuelConsumptionLow3`	`float`
`wltp_FuelConsumptionMed1`	`float`
`wltp_FuelConsumptionMed2`	`float`
`wltp_FuelConsumptionMed3`	`float`
`wltp_FuelConsumptionHigh1`	`float`
`wltp_FuelConsumptionHigh2`	`float`
`wltp_FuelConsumptionHigh3`	`float`
`wltp_FuelConsumptionExtraHigh1`	`float`
`wltp_FuelConsumptionExtraHigh2`	`float`
`wltp_FuelConsumptionExtraHigh3`	`float`
`wltp_FuelConsumptionMixed1`	`float`
`wltp_FuelConsumptionMixed2`	`float`
`wltp_FuelConsumptionMixed3`	`float`
`wltp_FuelConsumptionWeighted1`	`float`
`wltp_FuelConsumptionWeighted2`	`float`
`wltp_FuelConsumptionWeighted3`	`float`
`wltp_EnergyConsumption1`	`int32`
`wltp_EnergyConsumption2`	`int32`
`wltp_EnergyConsumption3`	`int32`
`wltp_EnergyConsumptionWeighted1`	`int32`
`wltp_EnergyConsumptionWeighted2`	`int32`
`wltp_EnergyConsumptionWeighted3`	`int32`
`wltp_Range1`	`int32`
`wltp_Range2`	`int32`
`wltp_RangeCity1`	`int32`
`wltp_RangeCity2`	`int32`
`wltp_CO2TypI_1`	`float`
`wltp_CO2TypI_2`	`float`
`wltp_CO2TypI_3`	`float`
`nedc_FuelConsumptionCity1`	`float`
`nedc_FuelConsumptionCity2`	`float`
`nedc_FuelConsumptionCity3`	`float`
`nedc_FuelConsumptionCountryRoad1`	`float`
`nedc_FuelConsumptionCountryRoad2`	`float`
`nedc_FuelConsumptionCountryRoad3`	`float`
`nedc_Range`	`int32`
`eletricVehicleConfiguration`	`string`
`numberOfAxles`	`string`
`wheelbase1`	`int32`
`wheelbase2`	`int32`
`wheelbase3`	`int32`
`tireDimensionFront`	`string`
`tireDimensionRear`	`string`
`rimDimensionFront`	`string`
`rimDimensionRear`	`string`
`doubleCommand`	`bool`
`passengerAirbag`	`bool`
`rallyVehicle`	`bool`
`equipment1`	`string`
`equipment2`	`string`
`equipment3`	`string`
`wheelbase1Miminum`	`int32`
`wheelbase2Miminum`	`int32`
`wheelbase3Miminum`	`int32`
`maxSpeed`	`float`
`limitedSpeed`	`string`
`advancedBreakingsystemMC`	`string`
`address`	`string`
`city`	`string`
`postalCode`	`string`

Types and mappings

Status

Contains information about the status of the vehicle.

Type	Description
AVST	Decommissioned
ITRAFIK	In traffic
AVREG	Deregistered

Vehicle types

Contains information about the vehicle type.

Type	Description
PB	Passenger vehicle
LB	Truck
BUSS	Bus
SLÄP	Trailer
TR	Tractor
MC	Motorcycle
MOPED	Moped class I
MRED	Motorised work machine
TGHJUL	ATV
TGSNÖ	Snowmobile
TGV	All-terrain vehicle
TGSL	Terrain trailer
TGSK	Terrain snowmobile

Vehicle classes

Contains information about the vehicle class.

Type	Description
a	Tractor a
b	Tractor b
I	class I
II	class II, camper
LÄTT	Light-duty
TUNG	Heavy-duty
MRED1	Motorised work machine

Fuel codes

Contains a description of the fuel types the vehicle support.

Code	Description
1	Gasoline
2	Diesel
3	Electricity
4	Kerosene
6	Producer gas
7	Ethanol
9	LPG
16	Methane gas
17	Hydrogen gas
18	Other
19	Biodiesel
20	CNG
21	LNG

Fuel combination code

Contains a description of fuel combinations.

Code	Description
B	Bi-fuel
D	Dual-fuel
F	Flex fuel
T	Tri-fuel

Gearbox codes

Contains a description of the gearbox of the vehicle.

Code	Description
M	Manual
A	Automatic
T	Manual with addon
Z	Automatic with addon
V	Variomatic

Coupling codes

Contains a description of the couplings available on the vehicle.

Code	Description
1	Trailer ball
2	Towing hook
3	Clevis
4	Miscellaneous
5	Turntable
6	Ball socket
7	Drawbar eye
8	Pin
9	Agricultural drawbar
10	Detachable ball
11	Other

Area of use codes

Contains a description of the areas of usage of the vehicle.

Code	Description
11	Freight traffic
12	Taxi traffic
13	Bus traffic
14	Regular traffic
15	Vehicle rental
17	Emergency vehicles
18	Driving school
19	School bus (non-professional)
20	Per special decision
21	Taxi traffic (exempted for meter)
27	Rally car

Electric vehicle configuration

Contains a description of how the electric vehicle is configured.

Code	Description
EL	Electric only
Elhybrid	Hybrid electric, not externally chargeable
Laddhybrid	Plug-in hybrid, externally chargeable
Elhybrid bränslecell	Fuel-cell hybrid, not externally chargeable
Laddhybrid bränslecell	Fuel-cell plug-in hybrid, externally chargeable

Examples

We have put together a few example of how you can use search for vehicles to easy find data. Please note the last example were we show how you include company information.

Search for a licence plate

Freetext search, for this case it may be better to use filter_by=licencePlate:=YXD972 instead of q=YXD972.

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/vehicles?q=YXD972&query_by=licencePlate"
{
    {
    "facet_counts": [],
    "found": 1,
    "hits": [
        {
            "document": {
                "acquiredByOwner": 1666562400,
                "co2Driv1": 147.0,
                "color": "WHITE",
                "colorHex": "#FFFFFF",
                "consumption1": 5.6,
                "coupling1": "11",
                "curbWeight": 1732,
                "currentOwnerCompanyId": 1914247,
                "currentUserCompanyId": 2693627,
                "address": "TESTVÄGEN 1",
                "city": "STOCKHOLM",
                "postalCode": "12345",
                "cylinderVolume": 1968,
                "directImport": false,
                "doubleCommand": false,
                "eeg": "e1*2007/46*0217*26",
                "emissionClass": "EURO 6",
                "enginePowerHk1": 150,
                "enginePowerUnit1": "EG",
                "environmentalClassEURO": "6",
                "fabric": [
                    "Volkswagen"
                ],
                "fabricCode": "VW",
                "fourWheelDrive": true,
                "fuelCode1": "2",
                "gearbox": "A",
                "groupNumber": "904216",
                "height": 1886,
                "id": "3067040",
                "importer": "5560840968",
                "insuranceType": "ENSK",
                "lastInspection": 1737673200,
                "lastMileageDate": 1737673200,
                "length": 4878,
                "licencePlate": "YXD972",
                "manufacturingYearAndMonth": 201710,
                "maxLoadWeight": 643,
                "maxSpeed": 189.0,
                "maxTrailerWeightB": 1125,
                "maxTrailerWeightBExtB": 1875,
                "maxTrailerWeightKg": 1450,
                "maxWeightUnbreakedTrailer": 750,
                "mileageKm": 114038,
                "name": "VOLKSWAGEN, VW CADDY",
                "nedc_FuelConsumptionCity1": 6.3,
                "nedc_FuelConsumptionCountryRoad1": 5.2,
                "numberOfAxles": 2,
                "numberOfOwners": 6,
                "numberOfPassengers": 1,
                "onLease": true,
                "originCode": "INFÖRT",
                "passengerAirbag": true,
                "preregistered": 1509490800,
                "rallyVehicle": false,
                "registered": 1513897200,
                "registrationType": "1",
                "reusedLicencePlate": false,
                "rimDimensionFront": "6Jx16 ET50",
                "rimDimensionRear": "6Jx16 ET50",
                "soundLevel1": 70,
                "status": "ITRAFIK",
                "statusDate": 1666562400,
                "superEnvironmentalVehicle": false,
                "tireDimensionFront": "205/55 R16 94H rf.",
                "tireDimensionRear": "205/55 R16 94H rf.",
                "totalWeight": 2375,
                "tradeName": "CADDY",
                "type": "2KN",
                "variety": "BBDFSBX1",
                "vehicleCategoryEU": "N1",
                "vehicleClass": "LÄTT",
                "vehicleName": "VOLKSWAGEN, VW",
                "vehicleType": "LB",
                "vehicleYear": 2017,
                "version": "L0J2AD6AD62E088N1SN2VR27MMG2PLL371",
                "vin": "WV1ZZZ2KZJX043887",
                "wanted": false,
                "weightInDrivingCondition": 1732,
                "wheelbase1": 3006,
                "width": 1793
            },
            "highlight": {
                "licencePlate": {
                    "matched_tokens": [
                        "YXD972"
                    ],
                    "snippet": "<mark>YXD972</mark>"
                }
            },
            "highlights": [
                {
                    "field": "licencePlate",
                    "matched_tokens": [
                        "YXD972"
                    ],
                    "snippet": "<mark>YXD972</mark>"
                }
            ],
            "text_match": 578730123365711993,
            "text_match_info": {
                "best_field_score": "1108091339008",
                "best_field_weight": 15,
                "fields_matched": 1,
                "num_tokens_dropped": 0,
                "score": "578730123365711993",
                "tokens_matched": 1,
                "typo_prefix_score": 0
            }
        }
    ],
    "out_of": 11317782,
    "page": 1,
    "request_params": {
        "collection_name": "transportstyrelsen_20250202160026",
        "first_q": "YXD972",
        "per_page": 10,
        "q": "YXD972"
    },
    "search_cutoff": false,
    "search_time_ms": 0
}
}

Search for vin

Search for vin (vehicle identification number).

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/vehicles?q=WV1ZZZ2KZJX043887&query_by=vin"
{
    {
    "facet_counts": [],
    "found": 1,
    "hits": [
        {
            "document": {
                ...
}
}

Search for fabric

Searches for fabric, Volkswagen.

curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/vehicles?q=Volkswagen&query_by=fabric"
{
    "facet_counts": [],
    "found": 994542,
    "hits": [
        {
            "document": {
                ...
}
}