Vehicle REST API

Road Assistance

API returns vehicle technical details

Use of API requires a permission issued by Trafi and only Finnish data is available through API.

In order to use the API you must have the valid environment-specific username and password. Before any API requests, you need to obtain an API KEY. You will get a valid API KEY (it's called a ticket) by using the ticket API (Please, read how to use ticket API instructions).

The API KEY must be sent in the request custom header element (named ticket or x-api-key). If the API KEY value is valid then API request will be successful (http status code 200), otherwise it will fail (http status code 401). All API requests must be made over HTTPS. Request the username and password

API endpoints

  • https://api.bisnode.fi/vehicle/info/v1/roadassistance/ - production environment
  • https://api-test.bisnode.fi/vehicle/info/v1/roadassistance/ - test environment

API request parameters

ParameterDescription 
id Vehicle registration number or VIN X

GET https://api-test.bisnode.fi/vehicle/info/v1/roadassistance/{id}

API request and response example

curl 'https://api-test.bisnode.fi/vehicle/info/v1/roadassistance/RPT-248' -H 'x-api-key: 1234567890ABC'

Successful request and the API return results in JSON format.

{
    "id": {
        "type": "1",
        "registerPlate": "RTP-248",
        "vin": "TAU180910041903LR",
        "systemId": "0118414274",
        "previousregisterPlate": null
    },
    "details": {
        "vehicleClass": "M1",
        "makeCode": "762",
        "make": "Kia",
        "model": "  5ov 1400cm3 ",
        "status": "3",
        "vehicleGroup": [
            "121"
        ],
        "usage": "01",
        "registrationCertificatePart1": {
            "ordinal": 1,
            "printDate": "2018-09-10T00:00:00Z"
        },
        "registrationCertificatePart2": {
            "ordinal": 1,
            "printDate": "2018-09-10T00:00:00Z"
        }
    },
    "basicDetails": {
        "typeApprovalNumber": "e4*01/116*0085*01",
        "variant": "M211",
        "version": "521111",
        "commercialName": null,
        "typeCode": null,
        "firstDateOfUse": "20020000",
        "nextInspectionFromDate": "2005-06-30T00:00:00Z",
        "nextInspectionDueDate": "2005-10-31T00:00:00Z",
        "lastInspectionDate": null,
        "inspectionResult": null,
        "inspectionPost": null,
        "stabilityControl": false,
        "engineNumber": null,
        "percentageOfReplacedParts": 0,
        "manufacturer": "Kia Motors Corporation",
        "individuallyMadeInFinland": null,
        "individuallyImported": "1",
        "importCountry": "276",
        "foreignRegisterPlate": "ULKOM_REK",
        "locationOfVin": "19",
        "builtVehicle": false,
        "locationOfVinOther": null,
        "locationOfDoors": null,
        "color": "2",
        "additionalColor": null,
        "amountOfDoors": 5,
        "typeName": "BA",
        "firstRegistrationDate": "2018-09-10T00:00:00Z",
        "odometer": null
    },
    "specialClauses": null,
    "restrictions": [
        {
            "restrictionType": "10",
            "restrictionTypeSubspecies": null,
            "validFrom": null,
            "validTo": null,
            "subMission": null,
            "importance": 1,
            "timeLimit": null,
            "post": null,
            "registerPlatesLost": null
        }
    ],
    "owners": [
        {
            "bisnodeId": [
                "FI2101002037973"
            ],
            "financeCompany": false,
            "deliveryRestriction": 0,
            "id": "031066-235L",
            "dead": false,
            "lastNameMainUnit": "Alexandrov",
            "firstNameSubUnit": "Jarmo Juhani",
            "customerType": "0",
            "ownershipType": "01",
            "validFrom": "2018-09-10T00:00:00Z",
            "holdershipType": null,
            "marketingBan": false,
            "address": "Pesätie 21 A 1",
            "postCode": "90420",
            "postOffice": "OULU",
            "language": "fi",
            "post": null
        }
    ],
    "transferNotifications": null,
    "insurance": {
        "deliveryRestriction": 0,
        "insuranceCompanyCode": "04",
        "insuranceType": "01",
        "insuranceCompanyName": "A-vakuutus",
        "policyHolderBisnodeId": [
            "FI2101002037973"
        ],
        "policyHolderId": "031066-235L",
        "dead": false,
        "policyHolderName": "Alexandrov, Jarmo Juhani",
        "validFrom": "2018-09-10T00:00:00Z",
        "validTo": null,
        "post": null
    },
    "tranferPermit": null,
    "technicalData": {
        "structure": {
            "plateType": "01",
            "axelCount": 2,
            "locationOfVinInscription": null,
            "verificationOfVinInscription": false,
            "gearing": "1",
            "switchCount": 5,
            "manufacturersPlateLocation": null,
            "powerSteering": false,
            "assemblyInEU": null,
            "type": null,
            "material": null,
            "additionalDevices": null,
            "axelDetails": [
                {
                    "ordinal": 1,
                    "steering": true,
                    "steeringDeviceCoupling": null,
                    "weightReduce": false,
                    "dualWheel": false,
                    "liftable": false,
                    "drive": false,
                    "wheelBrakeType": null,
                    "parkingBrake": false,
                    "brakeCylinderRadius": null,
                    "brakeLeverLength": null,
                    "brakeForceReference": null,
                    "brakeDiscWidht": null,
                    "brakePressure": null,
                    "individualMassWeightReducesOn": null,
                    "roadMaxMass": 700,
                    "techicalMaxMass": 720,
                    "groupNumber": null,
                    "brake": false,
                    "steered": false,
                    "axelGroup": null,
                    "tyres": [
                        {
                            "ordinal": 1,
                            "type": "1",
                            "size": "175R14",
                            "wheelSize": null,
                            "offset": null,
                            "tireCode": "88S"
                        }
                    ]
                },
                {
                    "ordinal": 2,
                    "steering": false,
                    "steeringDeviceCoupling": null,
                    "weightReduce": false,
                    "dualWheel": false,
                    "liftable": false,
                    "drive": true,
                    "wheelBrakeType": null,
                    "parkingBrake": false,
                    "brakeCylinderRadius": null,
                    "brakeLeverLength": null,
                    "brakeForceReference": null,
                    "brakeDiscWidht": null,
                    "brakePressure": null,
                    "individualMassWeightReducesOn": null,
                    "roadMaxMass": 700,
                    "techicalMaxMass": 710,
                    "groupNumber": null,
                    "brake": false,
                    "steered": false,
                    "axelGroup": null,
                    "tyres": [
                        {
                            "ordinal": 2,
                            "type": "1",
                            "size": "175R14",
                            "wheelSize": null,
                            "offset": null,
                            "tireCode": "88S"
                        }
                    ]
                }
            ]
        },
        "engine": {
            "fuelType": "01",
            "cylinderVolume": 1400,
            "maxNetPower": null,
            "topSpeed": null,
            "cylinderCount": null,
            "engineId": null,
            "supercharger": false,
            "superchargerMakeModel": null,
            "intercooler": false,
            "carburetorMakeModel": null,
            "engineNoiseOnIdle": null,
            "engineNoiseOnByPass": null,
            "engineNoiseOnRpm": null,
            "cabinNoiseInBus": null,
            "idleRpm": null,
            "increasedIdleRpm": null,
            "maximunRpm": null,
            "emissionLevel": null,
            "emissions": null,
            "exhaustPurification": null,
            "fuelTank": null,
            "fuelConsumptions": null,
            "fuels": [
                {
                    "fuelType": "01",
                    "engineNoiseOnIdle": null,
                    "engineNoiseOnByPass": null,
                    "engineNoiseOnRpm": null,
                    "idleRpm": null,
                    "increasedIdleRpm": null,
                    "maximunRpm": null,
                    "emissions": null,
                    "fuelConsumptions": [
                        {
                            "consumptionType": "4",
                            "amount": 123
                        }
                    ]
                }
            ],
            "hybrid": false,
            "hybridType": null
        },
        "mass": {
            "roofLoad": null,
            "semiTrailerDrawbarMass": null,
            "semiTrailerDrawbarIndividualMass": null,
            "maxFifthWheelCouplingMass": null,
            "individualMass": 650,
            "roadMaxMass": 1400,
            "techicalMaxMass": 1430,
            "modulesMaxMass": null
        },
        "dimenions": {
            "loadUnitLength": null,
            "widthAtFrontAxel": null,
            "loadUnitWidth": null,
            "turningRearWidth": null,
            "turningRearOwerhang": null,
            "rearcornerLateralDisplacement": null,
            "totalLength": null,
            "frontOverhang": null,
            "rearOverhang": null,
            "width": null,
            "height": null,
            "turningFrontWidth": null,
            "turningFrontOwerhang": null,
            "straighteningLength": null,
            "towLength": null,
            "wheelbases": [
                {
                    "ordinal": 1,
                    "length": 2370
                }
            ]
        },
        "body": {
            "bodyType": null,
            "cabType": "1",
            "loadUnitType": null,
            "standingPlaceCount": null,
            "enclosedCapSpace": 0,
            "openCargoAreaLength": null,
            "enclosedCargoArealength": 0,
            "seatsBesideToDriver": 1,
            "seatCount": 5,
            "busBodyAdditionalEquipments": null,
            "sideShields": null,
            "underRunShields": null
        },
        "brakes": {
            "powerBreakingAndTransmission": "05",
            "powerBreakingAndTransmissionAdditionalInfo": null,
            "albAadjustmentPlateLocation": null,
            "albAuditPressure": null,
            "extraBrakes": null
        },
        "couplingDevices": null,
        "couplings": null,
        "lightCoupling": null,
        "separateCouplings": null,
        "safetyEquipments": [
            {
                "type": "et",
                "seatRow": 1,
                "location": "1",
                "mandatory": "1"
            },
            {
                "type": "vk",
                "seatRow": 1,
                "location": "1",
                "mandatory": "1"
            }
        ],
        "replacedParts": null,
        "vakADRList": null,
        "modificationInspections": null
    }
}

Swagger - Technical documentation