Kenteken API voor ontwikkelaars

Gratis API-sleutel

Snelstart

Stuur je sleutel mee als Authorization: Bearer … (of als X-API-Key). Zet een sleutel nooit in de URL of in code die je publiceert.

curl https://autoreiskosten.nl/api/v1/road-tax/65TPLT?province=utrecht \
  -H "Authorization: Bearer ark_jouw_sleutel"

const res = await fetch('https://autoreiskosten.nl/api/v1/vehicles/65TPLT', {
  headers: { Authorization: 'Bearer ' + process.env.ARK_API_KEY },
});
const { vehicle, energy, consumption } = await res.json();
console.log(vehicle.make, energy.label, consumption.lPer100, 'l/100km');

import os, requests

r = requests.get(
    "https://autoreiskosten.nl/api/v1/trip-cost/JSP61J",
    params={"distanceKm": 120, "charging": "home"},
    headers={"Authorization": f"Bearer {os.environ['ARK_API_KEY']}"},
    timeout=15,
)
print(r.json()["total"])  # euro

Voorbeeldantwoord van /road-tax/JSP61J?province=utrecht:

{
  "plate": "JSP61J",
  "province": "utrecht",
  "opcentenPercentage": 86.4,
  "tariffDate": "2026-07-01",
  "applicable": true,
  "kind": "personenauto",
  "fuelCategory": "emissievrij",
  "massRunningOrderKg": 1537,
  "perQuarter": 161,
  "perMonth": 53.67,
  "perYear": 644,
  "breakdown": { "hoofdsom": 105.41, "brandstoftoeslag": 0, "fijnstoftoeslag": 0, "opcenten": 55.96 },
  "notes": ["Emissievrij: 70% van het normale tarief in 2026."]
}

Endpoints

Basis-URL: https://autoreiskosten.nl/api/v1. Alle antwoorden zijn JSON; kentekens mogen met of zonder streepjes.

Elektrisch laden in /trip-cost: standaard rekenen we met snelladen als slechtste geval (charging=fast); home rekent alles tegen het thuistarief. Eigen prijzen kun je meegeven met homePrice, fastPrice en fuelPrice.

Limieten en abonnementen

Het tegoed telt aanroepen: een verzekeringsvergelijking kost 5, de rest 1. Elk antwoord bevat X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset. Zit je erover, dan krijg je een 429 met Retry-After:

{ "error": { "code": "quota_exceeded", "message": "Maandtegoed van 1.000 aanroepen (Gratis) is op. Mail [email protected] voor een hoger abonnement." } }

Foutcodes: invalid_plate, invalid_parameter (400), invalid_api_key (401), vehicle_not_found (404), quota_exceeded, rate_limited (429), upstream_error (502, niet afgeschreven).

Meer nodig?

Meer aanroepen, een vaste prijs of een eigen koppeling? Mail naar [email protected] met je sleutel-e-mailadres en je verwachte gebruik.

Veelgestelde vragen