Afrekening
Wat een aanvraag kost en hoe je dat kunt nagaan.
Prijzen per endpoint en feature
De API rekent af in credits. Elke aanvraag kost de basisprijs van haar endpoint, plus de features die gegevens opleveren en eventuele toeslagen die je kiest. De prijzen zijn in elk plan gelijk. Je plan bepaalt welke features je kunt gebruiken.
| Endpoint | Wat | Credits |
|---|---|---|
| fetch-organization | Bedrijfsprofiel met de basisgegevens | 5 |
| fetch-organization | Features, zie de volgende tabel | 1 tot 80 |
| fetch-organization | Toeslag AI-modus, ook zonder match | +20 |
| fetch-organization | Toeslag Realtime, voor elke geslaagde live-opvraging | +10 |
| fetch-person | Persoonsprofiel, inclusief webonderzoek (vanaf Plus) | 15 |
| fetch-person |
Feature shareholdings, alleen als die gegevens oplevert
|
+5 |
| fetch-person |
Feature network (Pro, Max), alleen als die gegevens oplevert
|
+25 |
| search-organizations | Eén pagina met resultaten, ook een lege | 1 |
| fetch-document | Eén geleverd document | 15 |
| signals | Eén pagina Signals of één afzonderlijk signaal | 20 |
| signals |
De onderwerpencatalogus /v1/signals/catalog
|
gratis |
| account, auth | Account, saldo, gebruik, sleutels, tokens en webhook-endpoints | gratis |
De features van fetch-organization vraag je afzonderlijk op. Elke feature kost alleen iets als die gegevens oplevert:
| Feature | Inhoud | Credits | Plan |
|---|---|---|---|
| related_persons | Bestuur | 2 | elk account |
| shareholders | Aandeelhouders (Bèta) | 5 | elk account |
| shareholders_deep | Diepgaande aandeelhoudersgegevens | 80 | Max |
| ubos | Uiteindelijk belanghebbenden (UBO, Bèta) | 10 | elk account |
| shareholdings | Deelnemingen (Bèta) | 5 | elk account |
| mergers_and_acquisitions | Fusies & overnames (M&A, Bèta) | 20 | elk account |
| network | Bedrijfsnetwerk (Bèta) | 25 | Pro, Max |
| publications | Historie: de registerbekendmakingen | 1 | elk account |
| financial_kpi | Financiële KPI’s | 1 | elk account |
| balance_sheet_accounts | Balans | 3 | elk account |
| profit_and_loss_account | Winst-en-verliesrekening (W&V) | 3 | elk account |
| annual_financial_statements | Jaarrekeningen (Markdown) | 5 | elk account |
| annual_financial_statements__html | Jaarrekeningen (HTML) | 5 | elk account |
| insolvency_publications | Insolventiepublicaties | 5 | elk account |
| news | Nieuws | 10 | elk account |
| website_content | Website-inhoud · alleen met AI-modus | gratis | elk account |
Met alle features en beide toeslagen kost een aanvraag aan fetch-organization hoogstens 215 credits. Deze omvang zit in Max.
Een monitor kost een vaste prijs per periode van 30 dagen, afhankelijk van het controle-interval. Aanmaken en de eerste nulmeting zijn gratis.
| Controle-interval | Credits per 30 dagen |
|---|---|
| elke dag | 50 |
| elke 3 dagen | 40 |
| elke 7 dagen | 20 |
| elke 30 dagen | 10 |
| Elke extra geslaagde controle in de periode | +2 |
Een interval tussen deze stappen kost evenveel als de eerstvolgende frequentere stap. Meer onder account/monitors.
Alleen betalen voor wat gegevens oplevert
Een feature zonder gegevens kost niets. Levert ze null of een lege lijst, dan betaal je er niet voor. Dat geldt voor elke feature, ook insolvency_publications: zonder insolventiepublicaties is die gratis.
De basisprijs en de toeslagen volgen eigen regels. De basisprijs betaal je voor elk geleverd bedrijfsprofiel. De AI-modus kost ook zonder match. Realtime kost voor elke geslaagde live-opvraging, ook als er in het register niets is veranderd. Meer onder Toeslagen.
Bij sommige features telt specifieke inhoud:
shareholdersenshareholders_deepkosten alleen iets als er actuele vermeldingen zijn. Alleen een historie is gratis.mergers_and_acquisitionskost alleen iets met transacties, zeggenschapsrelaties of rechtsopvolgingen.networkkost alleen iets met ten minste één verbinding.newskost iets zodra de lijst ten minste één artikel bevat.
fetch-organization laat een feature die niet in je plan zit weg en berekent haar niet.
Bij Zoeken & exporteren, documenten en Signals betaal je voor de aanvraag zelf: één pagina met resultaten, één document, één pagina Signals. Een zoekopdracht zonder resultaten en een lege pagina Signals worden ook berekend.
Een mislukte of geweigerde aanvraag kost niets, zie Fouten.
Toeslagen voor AI-modus en Realtime
fetch-organization heeft twee toeslagen die je per aanvraag aanzet.
AI-modus (ai_search=on-default, +20 credits) vindt het bedrijf ook bij vage invoer en onderzoekt op het web. Hij wordt berekend zodra het onderzoek is uitgevoerd, ook als er geen bedrijf wordt gevonden of de gegevensbron een fout meldt. Alleen als de API de aanvraag met 408 afbreekt, wordt hij niet berekend.
Realtime (realtime_mode=handelsregister-default, +10 credits) haalt de ingeschreven personen live op uit het Handelsregister (Duits handelsregister). De toeslag berekenen we als de live-opvraging slaagt, ongeacht wat ze oplevert. Dan heeft _realtime_mode.status de waarde success.
Elke andere waarde daar betekent dat de live-opvraging is mislukt. Je krijgt dan de opgeslagen gegevens en betaalt voor de rest van de aanvraag, zonder de Realtime-toeslag. Duurt de aanvraag te lang, dan antwoordt de API met 408 en berekent niets.
1{2 "name": "Hetzner Online GmbH",3 "_realtime_mode": {4 "mode": "handelsregister-default",5 "status": "success"6 },7 "meta": {8 "request_credit_cost": 15,9 "credits_remaining": 14510 }11}
Kosten in het antwoord
Elk antwoord zegt wat het kostte. In JSON-antwoorden staat dat in meta, bij documenten in headers.
| Waar | Betekenis |
|---|---|
| meta.request_credit_cost |
Wat deze aanvraag kostte. Bij herhalingen met een idempotency-sleutel en bijna alle fouten is dat 0.
|
| meta.credits_remaining | Je saldo na de aanvraag. |
| X-Credits-Charged | signals en een geleverd document: wat de aanvraag kostte, als header. |
| X-Credits-Remaining | Een geleverd document: je saldo na de aanvraag, als header. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
Weigeringen bij authenticatie (401, 403) en boven de limiet (429) komen meestal zonder meta. Ze kosten nooit iets.
Elke afschrijving vind je onder Account › Gebruik en via de API op GET /v1/account/usage/transactions, zie account.
Niet genoeg credits
Voordat de API een aanvraag verwerkt, controleert ze of je saldo de hoogst mogelijke kosten dekt: basisprijs, alle gevraagde features en de toeslagen. Is dat niet zo, dan antwoordt de API met 402 en berekent niets.
Het antwoord toont dit maximum in meta.request_credit_cost en je saldo in meta.credits_remaining. Het later berekende bedrag is vaak lager, omdat features zonder gegevens niets kosten.
Een voorbeeld: basisgegevens met AI-modus en de feature ubos vragen vooraf 35 credits. Levert ubos geen gegevens, dan kost de aanvraag 25 credits.
signals antwoordt met Problem Details en de code INSUFFICIENT_CREDITS.
Creditabonnement en top-up-credits
Elk nieuw account krijgt 150 startcredits. Die zijn 30 dagen geldig.
Met een creditabonnement (Plus, Pro, Max of Enterprise) krijg je elke maand credits. Die zijn geldig tot het einde van de factuurperiode. Wissel je van plan, dan neem je ongebruikte maandcredits mee naar de nieuwe periode. Vanaf Plus kun je fetch-person gebruiken; Pro en Max ontgrendelen extra gegevens.
Top-up-credits koop je eenmalig, bovenop. Zonder creditabonnement zijn ze 30 dagen geldig. Zolang er een creditabonnement loopt, vervallen top-up-credits noch startcredits.
Je saldo en wat wanneer vervalt, zie je onder Account › Credits en via de API op GET /v1/account/credits.
Alle plannen en prijzen staan op de prijspagina.