Taxcalc.dk – gå til forsiden

Taxcalc API

Brug de samme beregnere som på Taxcalc.dk i dine egne systemer. API'et svarer med JSON og kan kaldes med en API-nøgle fra Dansk Motor Finans.
Hent OpenAPI-spec

Adresser

MiljøBase-URL
Produktionhttps://api.taxcalc.dk

Godkendelse

Send nøglen i en af de to headere:
Authorization: Bearer tc_<prefix>_<hemmelighed>
X-API-Key: tc_<prefix>_<hemmelighed>

Grænser

KaldGrænse
Med API-nøgle120 kald pr. minut som standard, op til 6.000 pr. nøgle
Uden nøgle120 beregninger pr. minut pr. IP-adresse

Fejl

StatusBetydningSvar
400Ugyldigt input (fx ugyldig JSON, forkert type, eller taxableValueCustom mangler ved ny bil eller ikke er et endeligt tal).–
401Ugyldig, ukendt eller slettet API-nøgle.{"status":"fejl","fejl":{"navn":"Unauthorized","besked":"Ugyldig API-nøgle."}}
403API-nøglen er deaktiveret.{"status":"fejl","fejl":{"navn":"Forbidden","besked":"API-nøglen er deaktiveret."}}
422Beregningen gav intet resultat eller en fejl (fx fri bil for et år uden satser).–
429For mange kald (pr. nøgle eller pr. IP uden nøgle).{"status":"fejl","fejl":{"navn":"RateLimit","besked":"For mange forespørgsler. Prøv igen om lidt."}}
503API-nøglen kunne ikke kontrolleres lige nu (fail closed). Prøv igen.{"status":"fejl","fejl":{"navn":"ServiceUnavailable","besked":"Prøv igen om lidt."}}

Endpoints

POST /v1/registration-fee Registreringsafgift (personbil/varebil)

curl -X POST "https://api.taxcalc.dk/v1/registration-fee" \
  -H "Authorization: Bearer $TAXCALC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"versionYear":2027,"vehicleType":1,"isHighWeight":false,"isNew":true,"taxableValueCustom":400000,"newPrice":400000,"tradePrice":400000,"emissionValue":120,"emissionUnit":2,"electricConsumption":0,"electricRange":0,"version":3}}'

POST /v1/motorcycle Motorcykel

curl -X POST "https://api.taxcalc.dk/v1/motorcycle" \
  -H "Authorization: Bearer $TAXCALC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"versionYear":2026,"isNew":true,"taxableValueCustom":150000,"newPrice":150000,"tradePrice":150000,"isElectric":false,"version":3}}'

POST /v1/veteran-car Veteranbil

curl -X POST "https://api.taxcalc.dk/v1/veteran-car" \
  -H "Authorization: Bearer $TAXCALC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"versionYear":2026,"taxableValueCustom":200000,"newPrice":300000,"tradePrice":200000,"version":3}}'

POST /v1/free-car-tax Beskatning af fri bil

curl -X POST "https://api.taxcalc.dk/v1/free-car-tax" \
  -H "Authorization: Bearer $TAXCALC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"year":2026,"taxBasis":400000,"ownershipTax":2000,"taxMargin":42}}'

POST /v1/period-tax Periodeafgift

curl -X POST "https://api.taxcalc.dk/v1/period-tax" \
  -H "Authorization: Bearer $TAXCALC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"registrationFee":100000,"leasingPeriodInMonths":12,"vehicleAgeInMonths":24,"wasInterrupted":false,"leasingPeriodRunWhenInterrupted":0}}'

POST /v1/new-price Nypris

curl -X POST "https://api.taxcalc.dk/v1/new-price" \
  -H "Authorization: Bearer $TAXCALC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"newPriceWithoutEquipment":300000,"equipmentPrice":20000,"technicalNewPrice":310000}}'

POST /v1/trade-price Handelspris

curl -X POST "https://api.taxcalc.dk/v1/trade-price" \
  -H "Authorization: Bearer $TAXCALC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"firstRegDate":"2022-03-01T00:00:00.000Z","mileage":45000,"equipmentPrice":10000,"qualityId":2,"specialUseId":0,"adverts":[{"firstRegDate":"2022-01-15T00:00:00.000Z","mileage":50000,"salesPrice":250000,"equipmentPrice":8000,"vehicleSold":false,"advertActive":true},{"firstRegDate":"2021-11-01T00:00:00.000Z","mileage":60000,"salesPrice":235000,"equipmentPrice":12000,"vehicleSold":true,"advertActive":false}]}}'

GET /v1/rate-sets Satssæt

curl -X GET "https://api.taxcalc.dk/v1/rate-sets" \
  -H "Authorization: Bearer $TAXCALC_API_KEY"

GET /v1/health Status

curl -X GET "https://api.taxcalc.dk/v1/health"