Etsi
Vehicle REST API

CodeSet

Returns descriptions of codes of vehicle APIs

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.

API endpoints

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

API request parameters

Parameter Description
model Model you find in Swagger at compact, technical, basic, extended and history endpoints
field Field name

API request and response example

curl 'https://api-test.bisnode.fi/vehicle/info/v1/codeset?model=Restriction%20&field=restrictionType' -H 'x-api-key: 1234567890ABC'

Successful request and the API return results in JSON format.

[
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "01",
    "description": "Alteration prohibition"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "02",
    "description": "Pending"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "03",
    "description": "Driving ban"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "04",
    "description": "Vehicle tax exemption"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "05",
    "description": "Sales restriction"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "06",
    "description": "Monitoring inspection obligation"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "07",
    "description": "Monitoring inspection obligation neglected"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "08",
    "description": "Alteration inspection obligation"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "09",
    "description": "Recall"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "29",
    "description": "Period of non-use"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "30",
    "description": "License plates returned"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "31",
    "description": "License plates stored"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "32",
    "description": "Additional plate"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "33",
    "description": "Notification of selling"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "34",
    "description": "Driving ban due to license plate repossession"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "10",
    "description": "Annual vehicle inspection not performed"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "11",
    "description": "Vehicle stolen"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "12",
    "description": "License plates stolen"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "13",
    "description": "Alteration ban imposed by Trafi"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "14",
    "description": "Alteration ban"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "15",
    "description": "Pending data"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "16",
    "description": "Mortgage data"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "17",
    "description": "Insurance unpaid data"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "18",
    "description": "Vehicle decommissioning"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "19",
    "description": "Final deregistration"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "20",
    "description": "Deregistration"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "21",
    "description": "Valid export registration"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "22",
    "description": "Vehicle tax overdue"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "23",
    "description": "Vehicle tax surtax overdue"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "24",
    "description": "Old vehicle tax / diesel tax overdue"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "25",
    "description": "License plates repossessed"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "26",
    "description": "Vehicle tax refunded"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "27",
    "description": "Other note"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "28",
    "description": "Ordinary note"
  },
  {
    "model": "Restriction",
    "field": "restrictionType",
    "value": "36",
    "description": "Additional tax pending"
  }
]

Swagger - Technical documentation