Introduction

Welcome to the Biluppgifter API! For API access, contact [email protected].

Authentication

# With shell, you can just pass the correct header with each request
curl api_endpoint_here
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

Biluppgifter uses API keys to allow access to the API.

Biluppgifter expects for the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: Bearer api_key

Or like this, using a query parameter:

api_endpoint_here?api_token=api_key

You must replace api_key with your personal API key.

You should also include a valid user agent in every request when accessing the API.

API usage

This endpoint retrieves your API usage for the current period, and when the next reset is due.

HTTP Request

GET https://api.biluppgifter.se/api/auth/me

curl https://api.biluppgifter.se/api/auth/me
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
    "data": {
        "name": "API-Token for Webservice",
        "token": "*stripped*",
        "user": {
            "data": {
                "name": "Api user",
                "email": "[email protected]"
            }
        },
        "quota": {
            "data": {
                "usage": 13,
                "limit": 100,
                "next_reset": "2019-01-01T00:00:00+01:00"
            }
        }
    }
}

Vehicle

Get vehicle by registration number

curl https://api.biluppgifter.se/api/v1/vehicle/regno/EYS061
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
    "data": {
        "type": "vehicle",
        "attributes": {
            "regno": "EYS061",
            "vin": "WDD2462001N016340"
        },
        "links": [
            {
                "rel": "self",
                "uri": "vehicle/vin/WDD2462001N016340"
            }
        ],
        "basic": {
            "data": {
                "make": "Mercedes",
                "model": "B 180 CDI",
                "color": "Vit",
                "type": "PB"
            }
        },
        "inspection": {
            "data": {
                "latest_inspection": "2018-01-10T00:00:00+01:00",
                "inspection_valid_until": "2019-03-31T00:00:00+01:00",
                "meter": 62635,
                "next_inspection_range": [
                    "2018-12-01T00:00:00+01:00",
                    "2019-03-31T00:00:00+01:00"
                ]
            }
        },
        "status": {
            "data": {
                "status": 2,
                "imported": false,
                "leasing": false,
                "bought_on_credit": true,
                "pre_registered": "2012-08-29",
                "first_registered": "2012-08-29",
                "first_on_swedish_roads": "2012-09-07",
                "number_of_owners": 4,
                "latest_owner_change": "2016-01-26T00:00:00+01:00",
                "tax": 1416,
                "tax_month": "apr"
            }
        },
        "technical": {
            "data": {
                "power_hp_1": 109,
                "power_hp_2": 0,
                "power_hp_3": 0,
                "power_kw_1": 80,
                ...
            }
        },
        "owner": {
            "data": {
                ...
            }
        }
    }
}

This endpoint retrieves a vehicle by registration number.

You can specify a specific country by including the country code.

Available countries are:

Sweden
Norway
Finland
Denmark

Note that the output may differ depending on which country you are searching in.

HTTP Request

GET https://api.biluppgifter.se/api/v1/vehicle/regno/<regno>

URL Parameters

Parameter	Description
regno	The registration number of the vehicle to retrieve

Query Parameters

Parameter	Default	Description
active	0	Set this to 1 to only return a vehicle if it's not de-registered
include	-	See packages for an explanation
country_code	SE	Country code. Accepts SE, FI, NO, NO2, DK

Get vehicles by registration numbers (batch)

curl -d '{"regnos": ["XTK493", "NLA828"], "include": "basic,status"}'
    -X POST https://api.biluppgifter.se/api/v1/vehicle/regnos
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
    "data": [
        {
            "type": "vehicle",
            "attributes": {
                "regno": "NLA828",
                "vin": "WVWZZZ3CZDE010906"
            },
            "links": [
                {
                    "rel": "self",
                    "uri": "vehicle/vin/WVWZZZ3CZDE010906"
                },
                {
                    "rel": "biluppgifter",
                    "uri": "https://biluppgifter.se/fordon/NLA828"
                }
            ],
            "basic": {
                "data": {
                    "make": "Volkswagen",
                    "model": "Passat Alltrack 2.0 TDi 4Motion",
                    "status": null,
                    "color": "Mörkbrun",
                    "type": "PB",
                    "type_class": "I",
                    "vehicle_year": 2012,
                    "model_year": 2013,
                    "reused_regno": true
                }
            },
            "status": {
                "data": {
                    "status": 1,
                    "imported": false,
                    "origin_code": 2,
                    "manufacture_month": "2012-06",
                    "manufacture_country": "Tyskland",
                    "leasing": false,
                    "bought_on_credit": false,
                    "pre_registered": "2012-06-18",
                    "first_registered": "2012-06-18",
                    "first_on_swedish_roads": "2012-07-12",
                    "number_of_owners": 4,
                    "latest_owner_change": "2019-10-13",
                    "tax": 3397,
                    "malus_tax": null,
                    "tax_month": "jan"
                }
            }
        },
        {
            "type": "vehicle",
            "attributes": {
                "regno": "XTK493",
                "vin": "JMZBK14Z271373833"
            },
            "links": [
                {
                    "rel": "self",
                    "uri": "vehicle/vin/JMZBK14Z271373833"
                },
                {
                    "rel": "biluppgifter",
                    "uri": "https://biluppgifter.se/fordon/XTK493"
                },
                {
                    "rel": "anonymous",
                    "uri": "https://biluppgifter.se/brukare/person/AOLPVVoJOJ/vAOLZ1varJ"
                }
            ],
            "basic": {
                "data": {
                    "make": "Mazda",
                    "model": "3 1.6",
                    "status": null,
                    "color": "Grå",
                    "type": "PB",
                    "type_class": "I",
                    "vehicle_year": 2006,
                    "model_year": 2006,
                    "reused_regno": false
                }
            },
            "status": {
                "data": {
                    "status": 2,
                    "imported": false,
                    "origin_code": 2,
                    "manufacture_month": "2006-02",
                    "manufacture_country": "Japan",
                    "leasing": false,
                    "bought_on_credit": false,
                    "pre_registered": "2006-03-29",
                    "first_registered": "2006-03-29",
                    "first_on_swedish_roads": "2006-04-28",
                    "number_of_owners": 3,
                    "latest_owner_change": "2013-10-16",
                    "tax": 1702,
                    "malus_tax": null,
                    "tax_month": "jun"
                }
            }
        }
    ]
}

This endpoint retrieves a list of vehicles by an array of registration numbers.

HTTP Request

POST https://api.biluppgifter.se/api/v1/vehicle/regnos

Query Parameters

Parameter	Default	Description
regnos		Array of registration numbers to search for. Max 25 registration numbers per request.
inactive		Set this to 1 to also include de-registered vehicles
include		See packages for an explanation
country_code	SE	Country code. Accepts SE

Get vehicle by vin number

curl https://api.biluppgifter.se/api/v1/vehicle/vin/WDD2462001N016340
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
    "data": {
        "type": "vehicle",
        "attributes": {
            "regno": "EYS061",
            "vin": "WDD2462001N016340"
        },
        "links": [
            {
                "rel": "self",
                "uri": "vehicle/vin/WDD2462001N016340"
            }
        ],
        "basic": {
            "data": {
                "make": "Mercedes",
                "model": "B 180 CDI",
                "color": "Vit",
                "type": "PB"
            }
        },
        "inspection": {
            "data": {
                "latest_inspection": "2018-01-10T00:00:00+01:00",
                "inspection_valid_until": "2019-03-31T00:00:00+01:00",
                "meter": 62635,
                "next_inspection_range": [
                    "2018-12-01T00:00:00+01:00",
                    "2019-03-31T00:00:00+01:00"
                ]
            }
        },
        "status": {
            "data": {
                "status": 2,
                "imported": false,
                "leasing": false,
                "bought_on_credit": true,
                "pre_registered": "2012-08-29",
                "first_registered": "2012-08-29",
                "first_on_swedish_roads": "2012-09-07",
                "number_of_owners": 4,
                "latest_owner_change": "2016-01-26T00:00:00+01:00",
                "tax": 1416,
                "tax_month": "apr"
            }
        },
        "technical": {
            "data": {
                "power_hp_1": 109,
                "power_hp_2": 0,
                "power_hp_3": 0,
                "power_kw_1": 80,
                ...
            }
        },
        "owner": {
            "data": {
                ...
            }
        }
    }
}

This endpoint retrieves a vehicle by vin number.

HTTP Request

GET https://api.biluppgifter.se/api/v1/vehicle/vin/<vin>

URL Parameters

Parameter	Description
vin	The vin number of the vehicle to retrieve

Query Parameters

Parameter	Default	Description
include		See packages for an explanation
country_code	SE	Country code. Accepts SE, NO, NO2, DK

Get vehicles by VIN numbers (batch)

curl -d '{"vins": ["WVWZZZ3CZDE010906", "JMZBK14Z271373833"], "include": "basic,status"}'
    -X POST https://api.biluppgifter.se/api/v1/vehicle/regnos
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
    "data": [
        {
            "type": "vehicle",
            "attributes": {
                "regno": "NLA828",
                "vin": "WVWZZZ3CZDE010906"
            },
            "links": [
                {
                    "rel": "self",
                    "uri": "vehicle/vin/WVWZZZ3CZDE010906"
                },
                {
                    "rel": "biluppgifter",
                    "uri": "https://biluppgifter.se/fordon/NLA828"
                }
            ],
            "basic": {
                "data": {
                    "make": "Volkswagen",
                    "model": "Passat Alltrack 2.0 TDi 4Motion",
                    "status": null,
                    "color": "Mörkbrun",
                    "type": "PB",
                    "type_class": "I",
                    "vehicle_year": 2012,
                    "model_year": 2013,
                    "reused_regno": true
                }
            },
            "status": {
                "data": {
                    "status": 1,
                    "imported": false,
                    "origin_code": 2,
                    "manufacture_month": "2012-06",
                    "manufacture_country": "Tyskland",
                    "leasing": false,
                    "bought_on_credit": false,
                    "pre_registered": "2012-06-18",
                    "first_registered": "2012-06-18",
                    "first_on_swedish_roads": "2012-07-12",
                    "number_of_owners": 4,
                    "latest_owner_change": "2019-10-13",
                    "tax": 3397,
                    "malus_tax": null,
                    "tax_month": "jan"
                }
            }
        },
        {
            "type": "vehicle",
            "attributes": {
                "regno": "XTK493",
                "vin": "JMZBK14Z271373833"
            },
            "links": [
                {
                    "rel": "self",
                    "uri": "vehicle/vin/JMZBK14Z271373833"
                },
                {
                    "rel": "biluppgifter",
                    "uri": "https://biluppgifter.se/fordon/XTK493"
                },
                {
                    "rel": "anonymous",
                    "uri": "https://biluppgifter.se/brukare/person/AOLPVVoJOJ/vAOLZ1varJ"
                }
            ],
            "basic": {
                "data": {
                    "make": "Mazda",
                    "model": "3 1.6",
                    "status": null,
                    "color": "Grå",
                    "type": "PB",
                    "type_class": "I",
                    "vehicle_year": 2006,
                    "model_year": 2006,
                    "reused_regno": false
                }
            },
            "status": {
                "data": {
                    "status": 2,
                    "imported": false,
                    "origin_code": 2,
                    "manufacture_month": "2006-02",
                    "manufacture_country": "Japan",
                    "leasing": false,
                    "bought_on_credit": false,
                    "pre_registered": "2006-03-29",
                    "first_registered": "2006-03-29",
                    "first_on_swedish_roads": "2006-04-28",
                    "number_of_owners": 3,
                    "latest_owner_change": "2013-10-16",
                    "tax": 1702,
                    "malus_tax": null,
                    "tax_month": "jun"
                }
            }
        }
    ]
}

This endpoint retrieves a list of vehicles by an array of VIN numbers.

HTTP Request

POST https://api.biluppgifter.se/api/v1/vehicle/vins

Query Parameters

Parameter	Default	Description
vins		Array of VIN numbers to search for. Max 25 VIN numbers per request.
inactive		Set this to 1 to also include de-registered vehicles
include		See packages for an explanation
country_code	SE	Country code. Accepts SE

Advanced search

This endpoint lets you use advanced filtering on most available fields when searching for vehicles.

HTTP Request

GET https://api.biluppgifter.se/api/v1/search?<query parameters>

Query Parameters

Functions

These functions are available, and can all be combined together.

Parameter	Description
where	Where the value is
where_not	Where the value is not
lte	Less than equal (only dates and numeric fields)
gte	Greater than equal (only dates and numeric fields)
in	Where the value is IN, comma separated list
not_in	Where the value is NOT IN, comma separated list
between	Where the value is between, comma separated (only dates and numeric fields)
prefix	The field should start with the value
suffix	The field should end with the value
wildcard	The field should contain the value

Parameters

Parameter	Default	Description
limit	15	Limit the number of vehicles to retrieve
page	1	Paginate the results, useful when combining with a limit
include	All packages	See packages for an explanation
country_code	SE	Country code. Accepts SE

Fields

The fields are named just as they are in the API output (excluding the "data" key) with the nested fields, and are combined as <function>[<field>].

So if you want to search a number of specific zip codes, you would write ?in[owner][address][zip_code]=69230,70348,70002.

If you would like to get vehicles that were first registered in traffic in March 2019, you would write ?gte[status][first_on_swedish_roads]=2019-03-01&lte[status][first_on_swedish_roads]=2019-03-31.

Company

Get vehicles by organization number

curl https://api.biluppgifter.se/api/v1/company/orgnr/2021006099
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
    "data": {
        "type": "company",
        "links": [
            {
                "rel": "self",
                "uri": "company/orgnr/2021006099"
            },
            {
                "rel": "biluppgifter",
                "uri": "https://biluppgifter.se/brukare/2021006099"
            }
        ],
        "attributes": {
            "orgnr": 2021006099,
            "status": "Aktivt",
            "status_detailed": "Aktivt",
            "legal_group": "Statlig enhet",
            "name": {
                "legal_name": "Transportstyrelsen"
            },
            "address": {
                "co": " ",
                "name": " ",
                "zip_code": 60173,
                "city": "NORRKÖPING"
            }
        },
        "vehicles": {
            "data": [
                {
                    "type": "vehicle",
                    "attributes": {
                        "regno": "EZK499",
                        "vin": "YV1BW84A1C1213710"
                    },
                    "links": [
                        {
                            "rel": "self",
                            "uri": "vehicle/vin/YV1BW84A1C1213710"
                        }
                    ],
                    ...
                }
            ],
            "meta": {
                "pagination": {
                    "total": 36,
                    "count": 15,
                    "per_page": 15,
                    "current_page": 1,
                    "total_pages": 3,
                    "links": {
                        "next": "https://api.biluppgifter.se/api/v1/company/orgnr/2021006099?limit=15&page=2"
                    }
                }
            }
        }
    }
}

This endpoint retrieves vehicles by a company. The output for each vehicle is the same as if you retrieved it directly, minus the owner data.

This endpoint is limited to those who has access to owner data.

You can specify a specific country by including the country code.

Available countries are:

Sweden
Norway

Note that the output may differ depending on which country you are searching in.

HTTP Request

GET https://api.biluppgifter.se/api/v1/company/orgnr/<orgnr>

URL Parameters

Parameter	Description	Format
orgnr	The organization number of the company to retrieve	Numbers only

Query Parameters

Parameter	Default	Description
limit	15	Limit the number of vehicles to retrieve
page	1	Paginate the results, useful when combining with a limit
include	All packages	See packages for an explanation
country_code	SE	Country code. Accepts SE, NO

Person

Get vehicles by personal identity number

curl https://api.biluppgifter.se/api/v1/person/pnr/*stripped*
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
    "data": {
        "type": "person",
        "links": [
            {
                "rel": "self",
                "uri": "person/pnr/*stripped*"
            },
            {
                "rel": "biluppgifter",
                "uri": "https://biluppgifter.se/brukare/person/AjMZZB19O9"
            }
        ],
        "attributes": {
            "pnr": *stripped*,
            "status": "Aktiv",
            "sex": "man",
            "birth_year": 1978,
            "name": {
                "given_name": "Christian",
                "first_name": "Christian",
                "middle_name": "",
                "last_name": "Nilsson",
                "full_name": "Nilsson, Christian"
            },
            "address": {
                "co": "",
                "name": "Litorinavägen 10",
                "zip_code": 30256,
                "city": "HALMSTAD"
            }
        },
        "vehicles": {
            "data": [
                {
                    "type": "vehicle",
                    "attributes": {
                        "regno": "EYS061",
                        "vin": "WDD2462001N016340"
                    },
                    ...
                }
            ],
            "meta": {
                "pagination": {
                    "total": 1,
                    "count": 1,
                    "per_page": 15,
                    "current_page": 1,
                    "total_pages": 1,
                    "links": []
                }
            }
        }
    }
}

This endpoint retrieves vehicles by a person. The output for each vehicle is the same as if you retrieved it directly, minus the owner data.

This endpoint is limited to those who has access to owner data.

HTTP Request

GET https://api.biluppgifter.se/api/v1/person/pnr/<pnr>

URL Parameters

Parameter	Description	Format
pnr	The personal identity number of the person to retrieve	12 characters, numbers only.

Query Parameters

Parameter	Default	Description
limit	15	Limit the number of vehicles to retrieve
page	1	Paginate the results, useful when combining with a limit
include	All packages	See packages for an explanation

TecDoc and engine code

These endpoints are for requesting TecDoc ID or engine code only.

You can specify a specific country by including the country code.

Available countries are:

Sweden
Norway
Finland
Denmark

If you need vehicle data as well, you can use the general vehicle endpoint instead by adding "tecDoc" to your include. Note that the general vehicle endpoint is currently only available for Swedish, Norwegian and Finnish vehicles.

Get data by registration number

curl https://api.biluppgifter.se/api/v1/tecdoc/regno/XTK493
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
    "data": {
        "type": "tecdoc",
        "attributes": {
        "tecdoc_id": "17669",
        "engine_code": "B6ZE"
        },
        "links": [
            {
                "rel": "self",
                "uri": "tecdoc/regno/XTK493?country_code=SE"
            }
        ]
    }
}

HTTP Request

GET https://api.biluppgifter.se/api/v1/tecdoc/regno/<regno>?country_code=SE

URL Parameters

Parameter	Description
regno	The registration number of the vehicle to retrieve information for

Query Parameters

Parameter	Default	Description
country_code	SE	Country code. Accepts SE, FI, NO, DK

EV data

These endpoints are for filtering and getting model based EV data.

Both PHEV and BEV data is available.

Filter models

Filters can be applied to make the search more specific. Aggregations with available values are always returned.

Quota is not deducted for this endpoint, you only pay when getting a specific model.

curl https://api.biluppgifter.se/api/v1/ev/filter?make=Audi
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
  "data": [
    {
      "type": "ev",
      "attributes": {
        "id": 1
      },
      "links": [
        {
          "rel": "self",
          "uri": "ev/1"
        }
      ],
      "basic": {
        "make": "Audi",
        "model": "A3 Sportback",
        "version": "40 TFSI e",
        "availability_from": "2020-10",
        "availability_to": null
      }
    },
    ..
  ],
  "meta": {
    "aggregations": {
      "make": [
        {
          "key": "Audi",
          "count": 48
        }
      ],
      "model": [
        {
          "key": "A3 Sportback",
          "count": 4
        },
        {
          "key": "A6 Avant",
          "count": 3
        },
        ..
      ],
      ..
    }
  }
}

HTTP Request

GET https://api.biluppgifter.se/api/v1/ev/filter

Query Parameters

Parameter	Description	Example
make	Make	Audi
model	Model	A3 Sportback
version	Version	40 TFSI e
availability_from	Year and month the version was made available	2020-10
availability_to	Year and month the version stopped being available

Get model by ID

For a specification of the EV data, please see this document.

curl https://api.biluppgifter.se/api/v1/ev/1
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
  "data": {
    "type": "ev",
    "attributes": {
      "id": 1
    },
    "links": [
      {
        "rel": "self",
        "uri": "ev/1"
      }
    ],
    "basic": {
      "make": "Audi",
      "model": "A3 Sportback",
      "version": "40 TFSI e",
      "availability_from": "2020-10",
      "availability_to": null
    },
    "battery": {
      "capacity_useable": 10.4,
      "capacity_full": 13,
      "capacity_estimate": "N"
    },
    "drivetrain": {
      "type": "PHEV",
      "fuel": "P",
      "propulsion": "Front",
      "power": 150,
      "power_hp": 204,
      "torque": 350
    },
    ..
  }
}

HTTP Request

GET https://api.biluppgifter.se/api/v1/ev/<id>

URL Parameters

Parameter	Description
id	The ID of the model to retrieve

Valuation

This endpoint is for valuating personal vehicles and light trucks.

Valuate vehicle

curl https://api.biluppgifter.se/api/v1/valuation/current/regno/XTK493?meter=90000
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
  "data": {
    "type": "valuation",
    "attributes": {
      "regno": "XTK493",
      "vin": "JMZBK14Z271373833"
    },
    "valuation": {
      "data": {
        "price": 40336
      }
    }
  }
}

HTTP Request

GET https://api.biluppgifter.se/api/v1/valuation/current/regno/<regno>

URL Parameters

Parameter	Description
regno	The registration number of the vehicle to valuate

Query Parameters

Parameter	Default	Description
meter	0	Current odometer in km
country_code	SE	Country code. Accepts SE

OEM

This endpoint is for requesting OEM data for vehicles.

Get data by VIN number

You can request OEM data by supplying a VIN number.

The way this endpoint work is that it's set up to poll our suppliers for the data. A status field is returned, which tells us the status of the background process.

You are free to make continuous requests to poll us for the data, you only pay for the request when it returns "Completed". If you request the same VIN multiple times, you pay for the request only once each month.

The status that can be returned are:

Status	Explanation
Created	The request has been received.
Running	We are requesting the data from our suppliers.
Completed	The request is complete, and you should be able to see OEM data in the response. You pay for the request when this is returned.
Failed	We were not able to request the data from our suppliers, this can be temporary or permanent. You can retry this request again in 2 hours.
Missing	Our suppliers does not have any data for the requested VIN.
Incomplete	We were able to request data, but equipment data is missing.

curl https://api.biluppgifter.se/api/v1/oem2/vin/WVWZZZ3CZGE084768
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
  "data": {
    "status": "Completed",
    "oem": {
      "data": {
        "type": "oem",
        "attributes": {
          "vin": "YV1XZ72VDL2229303"
        },
        "basic": {
          "data": {
            "make": "Volvo",
            "model": "VOLVO XC40 (536) 2.0 D3",
            "color_1": "Exterior : BLACK SOLID (STONE) (01900), Interior : CHARCOAL/ARIANNE/CHARCOAL (RD0000)",
            "color_2": null,
            "date_of_manufacturing": "30-12-2019",
            "date_of_registration": "26-09-2019",
            "wvta": null,
            "drive": "Front Wheel Drive",
            "engine": null,
            "power_ps": "150 PS",
            "power_kw": "110 kW",
            "body_type": "SUV",
            "capacity": "1969 ccm",
            "fuel_type_1": "Diesel",
            "fuel_type_2": null,
            "fuel_mixture": "Direct Injection",
            "model_year": "2020",
            "market_code": null,
            "transmission": "Automatic"
          }
        },
        "extended": {
          "data": [
            {
              "eq_code": "CN02",
              "group": "-",
              "description": "STOP/START Stop/Start"
            },
            {
              "eq_code": "V102",
              "group": "-",
              "description": "PARKING TICKET HOLDER With Ticket holder"
            },
            {
              "eq_code": "000179",
              "group": "-",
              "description": "Tinted windows"
            },
            {
              "eq_code": "L102",
              "group": "-",
              "description": "ALARM Alarm"
            },
            ...
          ]
        },
        "dimensions": {
          "data": {
            "weight": [
              {
                "label": "Curb Weight",
                "value": "(1,705 kg ) 1,674 kg"
              },
              {
                "label": "Gross Weight",
                "value": "2,180 kg"
              },
              {
                "label": "Max Trailer Load, braked 12%",
                "value": "1,800 kg"
              },
              {
                "label": "Max Trailer Load, braked 8%",
                "value": "1,800 kg"
              },
              {
                "label": "Max Trailer Load, unbraked",
                "value": "750 kg"
              },
              {
                "label": "Max Trailer Load, B-License",
                "value": "1,320 kg"
              },
              {
                "label": "Gross Train Weight",
                "value": "3,980 kg"
              },
              {
                "label": "Cargo Capacity",
                "value": "506 kg"
              },
              {
                "label": "Max Roof Load",
                "value": "75 kg"
              },
              {
                "label": "Permitted Axle Load, front",
                "value": "1,140 kg"
              },
              {
                "label": "Permitted Axle Load, rear",
                "value": "1,090 kg"
              }
            ],
            "interior": [
              {
                "label": "Head Room, Front",
                "value": "1,030 mm"
              },
              {
                "label": "Head Room, Rear",
                "value": "994 mm"
              },
              {
                "label": "Leg Room, Front",
                "value": "1,040 mm"
              },
              {
                "label": "Leg Room, Rear",
                "value": "917 mm"
              },
              {
                "label": "Hip Room, Front",
                "value": "1,390 mm"
              },
              {
                "label": "Hip Room, Rear",
                "value": "1,388 mm"
              },
              {
                "label": "Shoulder Room, Front",
                "value": "1,429 mm"
              },
              {
                "label": "Shoulder Room, Rear",
                "value": "1,040 mm"
              }
            ],
            "exterior": [
              {
                "label": "Length",
                "value": "4,425 mm"
              },
              {
                "label": "Width",
                "value": "(1,873 mm ) 1,863 mm"
              },
              {
                "label": "Width, with Mirrors",
                "value": "2,034 mm"
              },
              {
                "label": "Height",
                "value": "(1,632 mm ) 1,652 mm"
              },
              {
                "label": "Track, Front",
                "value": "1,601 mm"
              },
              {
                "label": "Track, Rear",
                "value": "1,626 mm"
              },
              {
                "label": "Wheel Base",
                "value": "2,702 mm"
              },
              {
                "label": "Turning Circle",
                "value": "11.4 m"
              },
              {
                "label": "Ground Clearance",
                "value": "211 mm"
              }
            ],
            "additional": [
              {
                "label": "Number of Seats",
                "value": "5"
              }
            ]
          }
        },
        "performance": {
          "data": {
            "general": [
              {
                "label": "Fuel",
                "value": "Diesel"
              },
              {
                "label": "Tank Volume",
                "value": "54 l"
              },
              {
                "label": "Fuel Cap Position",
                "value": "Rear"
              },
              {
                "label": "Right",
                "value": "Yes"
              },
              {
                "label": "Emission standard",
                "value": "Euro 6d"
              }
            ],
            "performance": [
              {
                "label": "Top Speed",
                "value": "200 km/h"
              },
              {
                "label": "Acceleration, 0-100 km/h",
                "value": "10.2 s"
              }
            ],
            "nedc": [
              {
                "label": "City",
                "value": "5.4 l/100km"
              },
              {
                "label": "Highway",
                "value": "4.7 l/100km"
              },
              {
                "label": "Combined",
                "value": "5 - 5.1 l/100km"
              },
              {
                "label": "CO? Emission, Combined",
                "value": "131 - 134 g/km"
              }
            ],
            "wltp": [
              {
                "label": "Low",
                "value": "7.6 l/100km"
              },
              {
                "label": "Medium",
                "value": "6 l/100km"
              },
              {
                "label": "High",
                "value": "5.1 l/100km"
              },
              {
                "label": "Extra High",
                "value": "6.4 l/100km"
              },
              {
                "label": "CO? Emission, Low",
                "value": "(199 g/km ) 198 - 209 g/km"
              },
              {
                "label": "CO? Emission, Medium",
                "value": "158 - 162 g/km"
              },
              {
                "label": "CO? Emission, High",
                "value": "132 - 141 g/km"
              },
              {
                "label": "CO? Emission, Extra High",
                "value": "168 - 179 g/km"
              },
              {
                "label": "CO? Emission, Combined",
                "value": "(156 g/km ) 156 - 165 g/km"
              },
              {
                "label": "CO Emission",
                "value": "209.7 mg/km"
              },
              {
                "label": "NOx Emission",
                "value": "52.7 mg/km"
              },
              {
                "label": "Particles",
                "value": "0.43 mg/km"
              },
              {
                "label": "THC+NOx Emission",
                "value": "109.8 mg/km"
              }
            ]
          }
        }
      }
    }
  }
}

HTTP Request

GET https://api.biluppgifter.se/api/v1/oem2/vin/<vin>

URL Parameters

Parameter	Description
vin	The VIN number of the vehicle to retrieve information for

Vehicle options and packages

With this endpoint, you can see how a vehicle was configured when it was first ordered from the retailer. You can see trim level, equipment, options, packages as well as prices for each individual choice, but also the whole vehicle.

Generate report by registration number

The way this endpoint work is that it's set up to generate a report. A status field is returned, which tells us the status of the report.

You are free to make continuous requests to poll us for the data, you only pay for reports that are completed.

HTTP Request

GET https://api.biluppgifter.se/api/v1/vehicle-configurator/regno/<regno>?country_code=SE

URL Parameters

Parameter	Description
regno	The registration number of the vehicle to retrieve information for

Query Parameters

Parameter	Default	Description
country_code	SE	Country code. Accepts SE

curl https://api.biluppgifter.se/api/v1/vehicle-configurator/regno/XJT609?country_code=SE
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
  "data": {
    "type": "request",
    "id": "0aM6VY0M2O",
    "attributes": {
      "regno": "XJT609",
      "vin": "WAUZZZF27MN079943"
    },
    "links": [
      {
        "rel": "self",
        "uri": "vehicle-configurator/0aM6VY0M2O"
      }
    ],
    "status": {
      "code": 4,
      "text": "Completed"
    },
    "reports": {
      "data": [
        {
          "dates": {
            "manufactured": "2021-03-30",
            "version_introduced": "2020-04-29"
          },
          "price": {
            "ex_vat": 609280,
            "with_vat": 761600
          },
          "options": {
            "list": [
              {
                "list": {
                  "english": [
                    "Trailer towing preparation includes tow hook which is electric folding",
                    "Trailer stability program"
                  ],
                  "swedish": [
                    "Dragkroksförberedelse med krok/ögla elektriskt hopfällbar",
                    "Stabilitetsprogram släp"
                  ]
                },
                "name": "Dragkrok",
                "price": {
                  "ex_vat": 7840,
                  "with_vat": 9800
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Rear side airbag"
                  ],
                  "swedish": [
                    "Sidokrockkuddar bak"
                  ]
                },
                "name": "Sidoairbags bak",
                "price": {
                  "ex_vat": 4320,
                  "with_vat": 5400
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Roof lining"
                  ],
                  "swedish": [
                    "Innertaksklädsel lyx"
                  ]
                },
                "name": "Innertak i tyg svart",
                "price": {
                  "ex_vat": 3200,
                  "with_vat": 4000
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Door mirrors/cameras ; light sensitive, door mirrors/cameras ; light sensitive with automatic tilt feature when reversing",
                    "Electrically foldable mirrors",
                    "Memorized adjustment controlling door mirror position"
                  ],
                  "swedish": [
                    "Ytterbackspeglar på förarsidan med automatiskt avbländande, ytterbackspeglar på passagerarsidan med automatisk indexering vid backning och automatiskt avbländande",
                    "Minnesfunktioner för ytterbackspegel"
                  ]
                },
                "name": "Ytterbackspeglar, elektriskt infällbara, automatiskt avbländbara, med minnesfunktion",
                "price": {
                  "ex_vat": 3520,
                  "with_vat": 4400
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Forward and reverse fully automatic park & exit including perpendicular parking",
                    "Front and rear radar-type parking distance system",
                    "Parking space information"
                  ],
                  "swedish": [
                    "Fullt atomatisk, utfart & fickparkering parkeringshjälp fram och bak",
                    "Parkeringssensorer fram, bak, radar",
                    "Parkeringsplatsinformation"
                  ]
                },
                "name": "Parkassistent",
                "price": {
                  "ex_vat": 4160,
                  "with_vat": 5200
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Adaptive windscreen wipers with integrated washer nozzles"
                  ],
                  "swedish": [
                    "Automatiska vindrutetorkare med integrerade spolarmunstycken"
                  ]
                },
                "name": "Automatiska vindrutetorkare med integrerade spolarmunstycken",
                "price": {
                  "ex_vat": 3600,
                  "with_vat": 4500
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Nineteen speakers with surround sound"
                  ],
                  "swedish": [
                    "19 högtalare med surroundljud"
                  ]
                },
                "name": "Bang & Olufsen 3D Premium Sound System",
                "price": {
                  "ex_vat": 8560,
                  "with_vat": 10700
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Control buttons in black glass optic"
                  ],
                  "swedish": [
                    "Knapplist på mittkonsolen och ljusreglage integrerade i svart glasoptik, reglage till rutor i aluminiumoptik."
                  ]
                },
                "name": "Reglage i svart glasoptik, med haptisk återkoppling, inklusive extra aluminiumoptik",
                "price": {
                  "ex_vat": 2960,
                  "with_vat": 3700
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Driver seat: reclining, electrically adjustable, five electrical adjustments adjustable fore/aft, height, lumbar support and tilt angle, passenger seat: reclining, electrically adjustable, five electrical adjustments adjustable fore/aft, height, lumbar support and tilt angle",
                    "Memorized adjustment controlling door mirror position"
                  ],
                  "swedish": [
                    "Förarsäte tilt lutningsbart, längdjusterbart och höjdjusterbart med svankstöd minne för justering av ryggstöd, minne för justering i längsled, minne för höjdjustering, minne för svankstöd och minne för tiltjustering, passagerarsäte tilt lutningsbart, längdjusterbart och höjdjusterbart med svankstöd elektrisk justering av ryggstöd, elektrisk justering i längsled, elektrisk höjdjustering, elektriskt svankstöd och elektrisk tiltjustering",
                    "Minnesfunktioner för ytterbackspegel"
                  ]
                },
                "name": "Framsäten elinställbara inklusive minnesfunktion för förarsätet",
                "price": {
                  "ex_vat": 9760,
                  "with_vat": 12200
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Headlights",
                    "Cornering lights/curb illumination",
                    "Headlight controlsystems: steering sensor, speed sensor, active high beam and LED matrix control"
                  ],
                  "swedish": [
                    "Kurvljus",
                    "Strålkastare riktade strålkastarre, hasighetsberoende, aktivt heljus och matris"
                  ]
                },
                "name": "HD matrix LED-strålkastare",
                "price": {
                  "ex_vat": 5520,
                  "with_vat": 6900
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Double glazing"
                  ],
                  "swedish": [
                    "Dubbelglas"
                  ]
                },
                "name": "Akustikglas för sidorutor",
                "price": {
                  "ex_vat": 4960,
                  "with_vat": 6200
                },
                "partner_id": null
              }
            ],
            "price": {
              "ex_vat": 58400,
              "with_vat": 73000
            }
          },
          "packages": {
            "list": [
              {
                "list": {
                  "english": [
                    "2 x 12v power outlet located in rear section",
                    "Cup holders for rear seats",
                    "Load restraint net"
                  ],
                  "swedish": [
                    "12V-uttag bak och 2",
                    "Mugghållare för baksäten",
                    "Lastförankring med nät"
                  ]
                },
                "name": "Förvaringspaket",
                "price": {
                  "ex_vat": 800,
                  "with_vat": 1000
                },
                "partner_id": null
              },
              {
                "list": {
                  "english": [
                    "Ambient lighting",
                    "Ambient lighting colour selection"
                  ],
                  "swedish": [
                    "Stämningsbelysning",
                    "Stämningsbelysning med färgval"
                  ]
                },
                "name": "Kontur-/miljöbelysningspaket, flerfärgs",
                "price": {
                  "ex_vat": 2560,
                  "with_vat": 3200
                },
                "partner_id": null
              }
            ],
            "price": {
              "ex_vat": 3360,
              "with_vat": 4200
            }
          },
          "services": [
            "Telematik avancerad automatisk krockvarning, via SIM i fordon med spårningssystem 0 månaders conciergetjänst med vägassistans",
            "Huvudservice: 30 000/och/24 mån och variabel distans/period"
          ],
          "trim_level": "S line",
          "warranties": [
            "Nybilsgaranti: 24 månader/och/obegränsad km",
            "Drivlinegaranti: 24 månader/och/obegränsad km",
            "Rostskyddsgaranti: 144 månader/och/obegränsad km",
            "Lackgaranti: 36 månader/och/obegränsad km",
            "Vägassistansgaranti: 999 månader/och/obegränsad km",
            "Batterigaranti 96, 160 000 och 99 420",
            "Garanti elsystem",
            "Nybilsgaranti - Fabrik 24, obegränsad och obegränsad",
            "Drivlinegaranti - Fabrik 24, obegränsad och obegränsad"
          ],
          "is_special_edition": false
        }
      ],
      "meta": {
        "count": 1,
        "type": {
          "code": 1,
          "text": "Full"
        }
      }
    }
  }
}

Get report

When you have generated a report, a report ID is returned. With this endpoint, you can retrieve that specific report again in the future.

HTTP Request

GET https://api.biluppgifter.se/api/v1/vehicle-configurator/<report id>

URL Parameters

Parameter	Description
report id	The report to retrieve

Available vehicles

The following makes, years and vehicle types are currently supported.

Make	Years	Types
Volkswagen	1998+	Cars
Audi	1998+	Cars
Seat	1998+	Cars
Skoda	1998+	Cars
BMW	1998+	Cars
Mini	1998+	Cars
Mercedes-Benz	2001+	Cars
Opel	2006+	Cars

Statuses

The following statuses can be returned.

Name	Code	Description
Created	1	A report has been requested
Running	2	A report is being generated
Failed	3	We were unable to generate a report
Completed	4	The report is ready

Report types

There are two report types:

Light

Light is a report without prices.

Full

Full is a report with prices. Many vehicles can exist in this report. If there are, you will have to use dates to filter the report, or if you know the trim level of the vehicle.

With this endpoint, you can view and request contact details for vehicles that are for sale on an ad site.

Get feed

List available vehicles that are for sale. You can filter the feed, and then request more details, including a link to the source ad and contact details for the owner.

You only pay when requesting details for an ad, feel free to call this endpoint as much as you'd like.

curl https://api.biluppgifter.se/api/v1/ad/feed
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
  "data": [
    {
      "type": "ad",
      "attributes": {
        "id": "l9avB2ZgaG",
        "date": "2022-09-09 17:56:28",
        "price": 87000,
        "make": "Volkswagen",
        "title": "Volkswagen Passat CC TDi 2.0",
        "model_year": 2010,
        "vehicle_type": "PB",
        "mileage": 179990,
        "location": {
          "municipality_code": "2180",
          "county_code": "21"
        },
        "phonenumber": {
          "has_phone": true,
          "has_unnixed_phone": false
        }
      },
      "links": [
        {
          "rel": "self",
          "uri": "ad/item/l9avB2ZgaG"
        }
      ]
    },
    ...
  ]
}

HTTP Request

GET https://api.biluppgifter.se/api/v1/ad/feed

Query Parameters

Parameter	Default	Description
min_price		Min price in SEK
max_price		Max price in SEK
min_mileage		Min mileage in KM
max_mileage		Max mileage in KM
min_model_year		Min model year
max_model_year		Max model year
municipalities		Municipality codes, comma separated in NNNN format
counties		County codes, comma separated in NN format
makes		Makes, comma separated
date_from		Date from in Y-m-d H:i:s format
date_to		Date to in Y-m-d H:i:s format
has_phone		Has phone number (true or false)
has_unnixed_phone		Has unnixed phone number (true or false)
limit	25	Limit. Max 50

Get ad

With the ID from the feed, you can request more details for an ad, including a link to the source ad and contact details.

curl https://api.biluppgifter.se/api/v1/ad/item/l9avB2ZgaG
    -H 'Authorization: Bearer api_key'
    -H 'Content-Type: application/json'
    -H 'Accept: application/json'
    -H 'User-Agent: My test client'

{
  "data": {
    "type": "ad",
    "attributes": {
      "id": "l9avB2ZgaG",
      "regno": *redacted*,
      "vin": *redacted*,
      "date": "2022-09-09 17:56:28",
      "price": 87000,
      "make": "Volkswagen",
      "title": "Volkswagen Passat CC TDi 2.0",
      "model_year": 2010,
      "vehicle_type": "PB",
      "mileage": 179990
    },
    "links": [
      {
        "rel": "self",
        "uri": "ad/item/l9avB2ZgaG"
      },
      {
        "rel": "blocket",
        "uri": "https://www.blocket.se/annons/gavleborg/volkswagen_passat_cc_tdi_2_0/*redacted*"
      }
    ],
    "owner": {
      "data": {
        "type": "person",
        "attributes": {
          "pnr": *redacted*,
          "sex": "man",
          "birth_year": 1991,
          "name": {
            "given_name": null,
            "first_name": *redacted*,
            "middle_name": null,
            "last_name": *redacted*,
            "full_name": *redacted*
          },
          "address": {
            "co": null,
            "name": *redacted*,
            "zip_code": 80634,
            "city": "Gävle",
            "municipality": "Gävle",
            "county": "Gävleborg",
            "municipality_code": "2180",
            "county_code": "21"
          },
          "phone_numbers": [
            {
              "number": *redacted*,
              "has_nix": true
            }
          ]
        }
      }
    }
  }
}

HTTP Request

GET https://api.biluppgifter.se/api/v1/ad/<id>

URL Parameters

Parameter	Description
id	The ad to retrieve

Packages

You can combine any packages in endpoints that accepts packages by comma, e.g. ?include=basic,status

It is recommended that you only include the packages that you need in your request, as it can decrease the request size significantly. A vehicle request with only the basic information included is about 1 KB, whereas a full request is about 5 KB. That's a 80% decrease in size.

Note that we may add new fields to any packages at any time, but we will not change the name of existing fields.

Package	Explanation	Included by default
basic	Basic information: make, model, vehicle year, etc	Yes
inspection	Latest inspection, meter and when the next inspection is due	Yes
status	Status information: status, purchase date, number of owners, tax, etc	Yes
technical	Technical data: fuel type, length, width, trailer weight, etc	Yes
history	History: inspections, status/owner changes, etc	Yes
owner	Owner information: orgnr/pnr, name, address, etc. Addresses are explained here.	Yes
realOwner	If the vehicle is leased, this is the leasing company: orgnr/pnr, name, address, etc	Yes
historicalOwners	Historical owner information: date of owner change, orgnr/pnr, name, address, etc	No
eco	Eco information: wltp and nedc tests (consumption and co2 emissions), etc	Yes
tire	Tire data	Yes
tecDoc	TecDoc ID and engine code	No

Explanation

Status types

These are the status types used in the status output

This is also the vehicle status type used in the history output

Type	Meaning
1	Avställd
2	I trafik
3	Avregistrerad
4	Aldrig i trafik

Purchase status types

These are the purchase status types used in the owner output. It denotes what kind of owner the user is.

Type	Meaning
1	Leasing
2	Bought on credit
3	Owner

Vehicle types

These are the vehicle types available in the basic output.

Type	Meaning
BUSS	Buss
LB	Lastbil
MC	Motorcykel
MOPED	Moped
MRED	Motorredskap
PB	Personbil
SLÄP	Släp
TGHJUL	Terränghjuling
TGSK	Terrängskoter
TGSL	Terrängsläp
TGSNÖ	Snöskoter
TGV	Terrängvagn
TR	Traktor

Vehicle types (high)

This is our amendment to the vehicle types of the Transport Agency.

Type	Meaning
BUSS	Buss
LB	Lastbil
MC	Motorcykel
MOPED	Moped
MRED	Motorredskap
PB	Personbil
SLÄP	Släp
TGHJUL	Terränghjuling
TGSK	Terrängskoter
TGSL	Terrängsläp
TGSNÖ	Snöskoter
TGV	Terrängvagn
TR	Traktor
LLB	Lätt lastbil
HB	Husbil
HV	Husvagn

Transmission types

These are the transmission types available in the technical data output.

Type	Meaning
1	Manuell
2	Automat
3	Manuell med tillsats
4	Automat med tillsats
5	Variomatic

Fuel types

These are the fuel types available in the technical data output

Type	Meaning
1	Bensin
2	Diesel
3	El
4	Fotogen
6	Gengas
7	Etanol
9	Motorgas
16	Metangas
17	Vätgas
18	Annat
19	Biodiesel
20	CNG
21	LNG

Hitch types

These are the hitch types available in the technical data output

Type	Meaning
1	Kula
2	Krok
3	Bygel
4	Övrig
5	Pivå vändskiva
6	Kulhandske
7	Ögla
8	Tapp
9	Jordbruksdrag
10	Kula (avtagbar)
11	Annan

Vehicle category codes

These are the vehicle category codes available in the technical data output

Type	Meaning
M1	Personbil
M1G	Personbil, terränggående
M2, M3	Buss
M2G, M3G	Buss, terränggående
N1, N2, N3	Lastbil
N1G, N2G, N3G	Lastbil, terränggående
O1, O2, O3, O4	Släp
T1, T2, T3, T4	Traktor, hjul
C1, C2, C3, C4	Traktor, band
L1E	2-hjulig moped
L2E	3-hjulig moped
L3E	2-hjulig MC
L4E	2-hjulig MC med sidovagn
L5E	3-hjulig MC
L6E	Lätt 4-hjuling
L7E	Tung 4-hjuling

Chassis

These are the chassis available in the technical data output.

Name
ambulans
bil
brandbil
buss
cabriolet
crossover
halvkombi
herrgårdsvagn
husbil
husvagn
kupé
lastbil
likbil
lätt lastbil
moped
motorcykel
motorredskap
pansarbil
pickup
polisbil
sedan
släp
snöskoter
terränghjuling
terrängskoter
terrängsläp
terrängvagn
traktor

Chassi codes

These are the chassi codes available in the technical data output.

Type	Meaning
0	Taxi
1	Rullstolsanpassat fordon
2	Tvåvånings låggolvsbuss
3	Cabriolet
4	Bärgningsfordon
5	Envånings låggolvsbuss
6	Motviktstruck
7	Stationsvagn kombivagn
8	Betongpump
9	Skördemaskin
10	Underrede isocontainer
11	Skåp verkstadsinredning
12	Bepansrat fordon
13	Täckt
14	Processor
15	Snöslunga
16	Tältvagn
17	Lastkombi
18	Tvåvånings låggolvsfordon
19	Ombyggd bil
20	Snabblås
21	Skåp kylaggregat
22	Tank övrigt
23	Chassi övrigt
24	Tank slam
25	Skåp kontorsinredning
26	Släpvagn transport exceptionell last
27	Ledad tvåvånings låggolvsbuss
28	Transport byggelement
29	Kombi
30	Envåningsfordon
31	Banke
32	Rullflaksväxlare löpvagn krokarm
33	Liftdumper
34	Campingbil
35	Flak stolpar
36	Dumper
37	Ledat tvåvåningsfordon
38	Skåp hyllor fack
39	Släpvagn fast dragstång
40	Skåp sjukvårdsinredning
41	Chassi tull
42	Busschassi
43	Person
44	Pickup
45	Anordning utbytbara karosserier
46	Personbefordran täckt skåp
47	Väghyvel
48	Containerunderrede flak
49	Sidlastare
50	Stege
51	Fordon fler ändamål
52	Skåp separat karosserienhet
53	Likvagnar
54	Likfordon
55	Rullflaksfästen
56	Envåningsfordon öppet tak
57	Ledad tvåvåningsbuss
58	Transport fordon
59	Flak fasta sidor
60	Tvåvåningsbuss
61	Kustbevakning
62	Polisbil
63	Ledat envåningsfordon
64	Mobilkran
65	Skåp
66	Tank kemiska vätskor
67	Öppet
68	Motorschaktvagn
69	Grävlastare
70	Personbefordran täckt flak
71	Tvåvåningsfordon öppet tak
72	Kombi taxi
73	Halvkombi
74	Brandfordon övrigt
75	Traktor
76	Transport djur
77	Transport fall
78	Anordning påhängsvagn
79	Ambulans
80	Tank asfalt
81	Containerunderrede
82	Tank gas
83	Transport arbetsmaskiner
84	Skåp butiksinredning
85	Ledat tvåvånings låggolvsfordon
86	Tank brandfarlig vätska
87	Flak
88	Ledad envånings låggolvsbuss
89	Flak bommar
90	Fällare
91	Markberedare
92	Terminaltraktor
93	Band
94	Kupé
95	Flak godslåda kapell
96	Likbil
97	Tank brandfarlig vätska klass1
98	Flak godslåda öppningsbar överdel
99	Chassi hytt eller chassi kåpa
100	Sopmaskin
101	Påhängsvagn
102	Växelflaksfästen centrallås
103	Dragfordon släpvagn
104	Ledat envånings låggolvsfordon
105	Hjulschaktare
106	Arbetsplattform
107	Tvåvåningsfordon
108	Lastbalja
109	Flak långgods
110	Personbefordran ledbuss
111	Tank brandfarlig vätska klass2b3
112	Chassi snabblås
113	Polisfordon
114	Mc sidovagn
115	Brandfordon
116	Växelflaksfästen containerlås
117	Skåp frysaggregat
118	Flak godslåda
119	Skotare
120	Transport båtar
121	Täckt lastutrymme gardinsidor
122	Hjulgrävmaskin
123	Skåp bostadsinredning
124	Flak lämmar kapell
125	Dollyaxel
126	Betongbehållare
127	Bostadsinredning
128	Dolly
129	Motorredskap
130	Mobilplattform
131	Lastbil
132	Skåp övrigt
133	Motorcykel
134	Tank mjölk
135	Täckt taklucka
136	Kombi taklucka
137	Envåningsbuss
138	Transport pulverf material
139	Traktor enaxlig
140	Hjul
141	Flak gallerlämmar
142	Specialgrupp
143	Lunnare
144	Ledad envåningsbuss
145	Minidumper
146	Flak lämmar
147	Mobilkran motorredskap klass1
148	Släpkärra
149	Tank vatten
150	Rullflaksväxlare krokarm
151	Släpvagn dragstång
152	Pansarfordon
153	Dragfordon påhängsvagn
154	Husvagn
155	Skördare
156	Chassi
157	Sedan
158	Växelflaksfästen två låssystem
159	Skåpbil
160	Personbefordran täckt
161	Lyfttruck övrigt
162	Hjullastare
163	Transport övrigt
164	Flak övrigt
165	Grensletruck
166	Envånings låggolvsfordon

Bus class

These are the bus classes available in the technical data output

Type	Meaning
1	I
2	II
3	III
4	A
5	B

Emission class

These are the eco classes available in the emission_class field for the eco/technical data output.

Type	Meaning
1	Euro 4
2	Euro 5
3	Euro 6
4	El
5	Elhybrid
6	Laddhybrid
7	EEV
8	Euro II
9	Euro III
10	Euro IV

Eco class

These are the eco classes available in the eco_class field for the eco/technical data output.

Type	Meaning
1	1E, Bilar som drivs med el (t.o.m. 2001)
2	1H, Bilar som drivs med el och förbränningsmotor, s.k. hybrid (t.o.m. 2001)
3	2000, Äldre bilar samt ett fåtal bilar i slutserier
4	2005, Bilar som uppfyller de krav obligatoriska i EU sen 2006
5	2005PM, Bilar med dieselmotor som klarar kraven i MK 2005 och har partikelfilter
6	2008, Bilar som uppfyller beslutade kommande krav
7	EEV, Bilar som uppfyller krav för särskilt miljövänliga fordon – frivillig
8	EL, Bilar som drivs med el (fr.o.m. 2002)
9	HYBRID, Bilar som drivs med el och förbränningsmotor (fr.o.m. 2002)
10	MK1, Äldre miljöklassning
11	MK2, Äldre miljöklassning
12	MK3, Äldre miljöklassning

Eco class EURO

These are the codes available for the eco_class_euro field in the eco package.

See heavy duty and light duty for more information.

Type	Meaning
1	Euro 1 (Light duty)
2	Euro 2 (Light duty)
3	Euro 3 (Light duty)
4	Euro 4 (Light duty)
5	Euro 5 (Light duty)
6	Euro 6 (Light duty)
7	Euro I (Heavy duty)
8	Euro II (Heavy duty)
9	Euro III (Heavy duty)
10	Euro IV (Heavy duty)
11	Euro V (Heavy duty)
12	Euro VI (Heavy duty)
13	Euro EEV
14	Euro U

Origin code

These are the origin codes available in the status output.

Type	Meaning
1	IMPORT, Importerad från EU-land
2	INFÖRT, Införd av registrerad importör
3	MIL, Tidigare militärregistrerad
4	REG, Tidigare registrerad i Sverige
5	TILLV, Egen tillverkning
6	TULL, Importerad från icke EU-land
7	TYP, Enligt typintyg
8	YTILLV, Liten yrkesmässig tillverkning
9	ÖVR, Övrigt

History types

These are the history types available in the history output.

Type	Meaning
10	Registered in a foreign country
11	Pre registered
12	First registered
13	Unregistered
14	EEG inspection
20	Vehicle status changed
21	New owner
22	Reported stolen
30	Vehicle inspection

Program codes

These are the program codes available in the inspection output of the history result.

Type	Meaning
A+B	Dubbla förelägganden finns
A1	Registreringsbesiktning, A1
A1E	Efterkontroll 1:a registreringsbesiktning, A1E
A2	Registreringsbesiktning, A2
A2+B	Dubbla förelägganden A2- + B
A2-	Registreringsbesiktning, A2-
A2-E	Efterkontroll A2-
AE	Efterkontroll registreringsbesiktning, AE
B	Kontrollbesiktning
BE	Efterkontroll kontrollbesiktning, BE
EEG	Typgodkännande EEG intyg
EFÄR	Efterkontroll färdskrivare
ENSK	Enskilt godkännande
FLE	Efterkontroll fFlygande inspektion
P1	Begränsad inspektion
P2	Fullständig inspektion
P3	Fullständig inspektion med provkörning / bromsprov
P4	Bevis ö̈vervakning genom polisman
TYP	Typgodkännande typintyg

Eco vehicle codes

These are the codes available for the eco_vehicle field in the eco package.

Type	Meaning
1	MB2007
2	MB2013

Electric or hybrid codes

These are the codes available for the electric_or_hybrid field in the eco package.

Type	Meaning
1	Laddhybrid
2	Elhybrid
3	El
4	Elhybrid B

Electric vehicle configuration codes

These are the codes available for the electric_vehicle_configuration field in the eco package.

Type	Meaning
1	Laddhybrid
2	Elhybrid
3	El
4	Elhybrid bränslecell
5	Laddhybrid bränslecell

Usage type

These are the codes available for the usage_type field in the status package.

Type	Meaning
11	Godstrafik
12	Taxitrafik
13	Busstrafik
14	Linjetrafik
15	Uthyrningsrörelse
17	Utryckningsfordon
18	Trafikskola
19	Ej yrkesmässig skolskjuts
20	Särskilt beslut
21	Taxitrafik - taxameterdispens
27	Rallybil

Vehicle type class

These are the codes available for the type_class field in the basic package.

For more information, please see this document.

Type	Text	Meaning
1	I	Personbil, klass I
2	II	Personbil, klass II, husbil
3	TUNG	Tung
4	LÄTT	Lätt
5	A	Traktor A
6	B	Traktor B
7	MRED1	Motorredskap

Addresses

Depending on the owner of the vehicle, there are different types of addresses shown.

The address shown in the "address" field of the owner package, is from either Bolagsverket or Skatteverket.

The address in the "ts_address" field, which is only shown for leased vehicles, is from Transportstyrelsen, and may differ from the "address" field.

{
    "address": {
        "co": null,
        "name": "BOX 1565",
        "zip_code": 17129,
        "city": "SOLNA",
        "municipality": "Solna",
        "county": "Stockholm",
        "municipality_code": "0184",
        "county_code": "01"
    },
    "ts_address": {
        "name": "C/O AUTOPLAN",
        "zip_code": 10534,
        "city": "STOCKHOLM",
        "municipality": "Stockholm",
        "county": "Stockholm",
        "municipality_code": "0180",
        "county_code": "01"
    }
}

Classifications

These are the classifications available for passenger cars.

Type	Meaning	Description
1	A-segment	Minibil
2	B-segment	Småbil
3	C-segment	Kompaktbil
4	D-segment	Mellanstor familjebil
5	E-segment	Stor familjebil
6	F-segment	Stor lyxbil
7	J-segment	Suv
8	M-segment	MPV
9	S-segment	Sportbil

Errors

The Biluppgifter API uses the following error codes:

Error Code	Meaning
400	Bad Request -- Your request is invalid.
401	Unauthorized -- Your API key is wrong.
403	Forbidden -- Quota exceeded.
404	Not Found -- The specified item could not be found.
405	Method Not Allowed -- You tried to access an endpoint with an invalid method.
406	Not Acceptable -- You requested a format that isn't json.
429	Too Many Requests -- Slow down!
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

Introduction

Authentication

API usage

HTTP Request

Vehicle

Get vehicle by registration number

HTTP Request

URL Parameters

Query Parameters

Get vehicles by registration numbers (batch)

HTTP Request

Query Parameters

Get vehicle by vin number

HTTP Request

URL Parameters

Query Parameters

Get vehicles by VIN numbers (batch)

HTTP Request

Query Parameters

Advanced search

HTTP Request

Query Parameters

Company

Get vehicles by organization number

HTTP Request

URL Parameters

Query Parameters

Person

Get vehicles by personal identity number

HTTP Request

URL Parameters

Query Parameters

TecDoc and engine code

Get data by registration number

HTTP Request

URL Parameters

Query Parameters

EV data

Filter models

HTTP Request

Query Parameters

Get model by ID

HTTP Request

URL Parameters

Valuation

Valuate vehicle

HTTP Request

URL Parameters

Query Parameters

OEM

Get data by VIN number

HTTP Request

URL Parameters

Vehicle options and packages

Generate report by registration number

HTTP Request

URL Parameters

Query Parameters

Get report

HTTP Request

URL Parameters

Available vehicles

Statuses

Report types

Ads

Get feed

HTTP Request

Query Parameters

Get ad

HTTP Request

URL Parameters

Packages

Explanation

Status types

Purchase status types

Vehicle types

Vehicle types (high)

Transmission types

Fuel types

Hitch types