Openbaar endpoint

Incassokosten-API
de WIK-staffel als één request.

Stuur een hoofdsom in eurocenten en u krijgt de buitengerechtelijke incassokosten volgens het Besluit BIK terug, plus de wettelijke rente of handelsrente als u een vervaldatum meegeeft. Geen account, geen API-key, geen registratie.

Naar het voorbeeld Liever de rekenmachine

Wie facturen incasseert, moet vroeg of laat uitrekenen wat er bovenop de hoofdsom mag. Dat is geen creatief werk: de staffel staat in het Besluit vergoeding voor buitengerechtelijke incassokosten en het antwoord is voor iedereen hetzelfde. Toch bouwt vrijwel elk boekhoud- en debiteurenpakket die berekening opnieuw, met eigen afrondingsfouten. Wij hebben hem al staan, dus kunt u hem gebruiken.

Het request en het antwoord

Eén POST naar https://nl.legal/api/v1/tools/wik. Bedragen gaan in eurocenten, zodat er geen afrondingsverschillen kunnen ontstaan: € 440,86 is 44086.

curl -X POST https://nl.legal/api/v1/tools/wik \
  -H "Content-Type: application/json" \
  -d '{
    "amount_cents": 44086,
    "debtor_type": "consumer",
    "due_date": "2026-01-15"
  }'

Het antwoord:

{
    "object": "wik_calculation",
    "debtor_type": "consumer",
    "principal_amount_cents": 44086,
    "collection_costs_cents": 6613,
    "collection_costs_vat_cents": 0,
    "interest": {
        "amount_cents": 990,
        "rate_percent": 4,
        "days": 206,
        "type": "wettelijke rente (art. 6:119 BW)"
    },
    "total_amount_cents": 51689,
    "basis": "Buitengerechtelijke incassokosten volgens het Besluit BIK (art. 6:96 BW). Indicatief; geen juridisch advies."
}

Velden

Veld	Type	Toelichting
`amount_cents`	integer	De hoofdsom in eurocenten. Verplicht, minimaal 1.
`debtor_type`	string	`consumer` of `business`. Bepaalt of er met wettelijke rente of met handelsrente wordt gerekend. Standaard `consumer`.
`due_date`	string (date)	Vervaldatum in `YYYY-MM-DD`. Laat u dit weg, dan rekenen wij geen rente.
`include_vat`	boolean	Telt 21% btw over de incassokosten mee. Relevant als u de btw niet kunt verrekenen. Standaard `false`.

Wat er precies wordt gerekend

De incassokosten volgen de staffel uit het Besluit BIK, gebaseerd op artikel 6:96 BW. Elk deel van de vordering krijgt een eigen percentage.

Deel van de hoofdsom	Percentage
Over de eerste € 2.500	15%, met een minimum van € 40
Over de volgende € 2.500	10%
Over de volgende € 5.000	5%
Over de volgende € 190.000	1%
Over het meerdere boven € 200.000	0,5%, met een maximum van € 6.775

De rente hangt af van wie de debiteur is. Bij een particulier rekenen wij met de wettelijke rente van artikel 6:119 BW, bij een zakelijke debiteur met de wettelijke handelsrente van artikel 6:119a BW. Het antwoord noemt het gebruikte percentage en het aantal dagen, zodat u kunt controleren waar het bedrag vandaan komt.

Berekenen is niet hetzelfde als mogen vorderen

Bij een particuliere debiteur mag u pas incassokosten in rekening brengen nadat u een correcte 14-dagen brief heeft gestuurd. Dit endpoint rekent alleen het bedrag uit en controleert niet of aan die voorwaarde is voldaan.

Codevoorbeelden

PHP

$ch = curl_init('https://nl.legal/api/v1/tools/wik');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'amount_cents' => 44086,
        'debtor_type'  => 'consumer',
        'due_date'     => '2026-01-15',
    ]),
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $result['collection_costs_cents']; // 6613

Python

import requests

result = requests.post(
    "https://nl.legal/api/v1/tools/wik",
    json={"amount_cents": 44086, "debtor_type": "consumer", "due_date": "2026-01-15"},
    timeout=10,
).json()

print(result["collection_costs_cents"])  # 6613

Voorwaarden en grenzen

Gratis en zonder API-key. U mag het endpoint in uw eigen software gebruiken.
Er geldt een rate limit per IP-adres. Bij normale toepassing in een boekhoudpakket loopt u daar niet tegenaan.
Fouten komen terug als application/problem+json volgens RFC 9457, met een errors-array per veld.
De uitkomst is een berekening, geen juridisch advies. Wij houden de staffel en de rentepercentages bij, maar u blijft zelf verantwoordelijk voor wat u aan uw debiteur schrijft.

Veelgestelde vragen

Nee. Dit endpoint staat open en vraagt geen authenticatie. Alleen de endpoints waarmee u echte incasso-opdrachten indient vragen om een key, die u aanvraagt via het contactformulier.

Omdat een bedrag als kommagetal in de ene taal anders afrondt dan in de andere. Met gehele getallen in centen krijgt iedereen dezelfde uitkomst. € 440,86 stuurt u dus als 44086.

Alleen als u de btw zelf niet kunt verrekenen, bijvoorbeeld als verhuurder van woningen of als medische praktijk. Stuur dan include_vat op true mee. Kunt u de btw wel verrekenen, dan is het voor u geen kostenpost en mag u die niet doorbelasten.

Ja. Wij vragen geen vergoeding en stellen geen eisen aan naamsvermelding. Houd er rekening mee dat er een rate limit per IP-adres geldt en dat de uitkomst indicatief is.

Geen enkel verschil in de uitkomst. De incassokostencalculator is bedoeld om zelf iets op te zoeken, dit endpoint om het in uw eigen software te laten gebeuren.

Verder bouwen

Wilt u niet alleen rekenen maar ook daadwerkelijk overdragen, dan is dit endpoint het kleinste onderdeel van de incasso API. Daarmee dient u vanuit uw eigen systeem een vordering in en krijgt u een dossiernummer terug. Wie liever niet bouwt, kan kiezen uit de andere manieren van indienen, waaronder de Moneybird-koppeling.

Het tweede openbare endpoint is de rechtbank-API, die de bevoegde kantonrechter en de eerstvolgende haalbare roldatum teruggeeft.

Vordering overdragen in plaats van uitrekenen?

Wij starten binnen 24 uur na indienen. De minnelijke fase gaat op basis van No Cure No Pay: levert het niets op, dan betaalt u niets voor onze uren.

Vordering indienen

Incassokosten-API de WIK-staffel als één request.