Veelgestelde vragen

Uit de officiële registers en publicaties: het Handelsregister (Duits handelsregister), het Unternehmensregister (ondernemingsregister) met de jaarrekeningen, en de insolventiepublicaties. Nieuws en website-inhoud komen van het web. Meer in Beschikbaarheid van gegevens.

Veel details lezen we automatisch uit de gepubliceerde documenten en bekendmakingen. We gebruiken daarvoor de nieuwste technologie en investeren veel in kwaliteit; afzonderlijke fouten blijven mogelijk.

Een bedrijfsprofiel komt uit onze database. Met Realtime vraagt de API het Handelsregister ook live op en levert de personen die op dat moment ingeschreven staan. Documenten haalt de API uit het register op wanneer je ze opvraagt.

Als hetzelfde document kort daarvoor al is opgehaald, kan het tot 24 uur oud zijn.

Bedrijven moeten jaarrekeningen uiterlijk twaalf maanden na de balansdatum publiceren, en veel bedrijven gebruiken die hele termijn. De nieuwste jaarrekening gaat daarom vaak over het jaar vóór vorig jaar.

Meestal omdat het bedrijf die niet hoeft te publiceren. Wat openbaar is, hangt af van rechtsvorm en omvang: een kleine GmbH publiceert bijvoorbeeld geen winst-en-verliesrekening, dus is er meestal geen omzet voor. Lege waarden staan als null of [] in het antwoord.

Bij een naam die meerdere bedrijven delen, kan de API een van hen teruggeven, niet per se het bedrijf dat je bedoelt, of met 404 antwoorden. Als je het exact wilt, vraag dan op met registerrechtbank en registernummer, bijvoorbeeld „Ansbach HRB 6089”, of met de entity_id. Het registernummer alleen is niet genoeg, want hetzelfde nummer bestaat bij veel rechtbanken.

Nee. Een feature wordt alleen berekend als die gegevens oplevert. De AI-modus wordt daarentegen ook berekend als die geen bedrijf vindt. Alleen als de API de aanvraag met 408 afbreekt, wordt die niet berekend. Realtime kost credits voor elke geslaagde live-opvraging, ook als die niets nieuws laat zien.

Niets. Een aanvraag die met een fout eindigt, wordt niet berekend; de enige uitzondering is de toeslag voor de AI-modus. Bij status 402 geeft meta.request_credit_cost aan wat de aanvraag maximaal gekost zou hebben. Meer in Fouten.

Nee. Bedrijfsprofielen, Zoeken & exporteren, documenten en Signals kun je met elk account gebruiken; je betaalt alleen de credits. Een creditabonnement ontgrendelt extra gegevens:

• Plus: het persoonsprofiel.
• Pro: de uitgebreide Financiële KPI’s, de feature Bedrijfsnetwerk, zoekfilters voor eigendom, bestuur en insolventie, en het Signals-onderwerp Insolventies.
• Max: alles van Pro, plus de feature Diepgaande aandeelhoudersgegevens, de activiteitenverslagen van energiebedrijven en het Signals-onderwerp Omzettingen & M&A.

Alles over prijzen en plannen staat in Afrekening.

Een nieuw account krijgt 150 startcredits. Zonder creditabonnement zijn startcredits en top-up-credits 30 dagen geldig. Zolang een creditabonnement actief is, vervallen ze niet.

Voor Realtime, persoonsprofielen en documenten minstens 120 seconden, omdat deze aanvragen langer duren. Als bij Realtime alleen de live-opvraging mislukt, krijg je de opgeslagen gegevens zonder de Realtime-toeslag. Duurt de aanvraag te lang, dan eindigt ze met 408, bij documenten met 504. Er wordt dan niets berekend. Probeer het later opnieuw.

Voor bedrijfsprofielen 60 aanvragen per minuut en account, voor documenten 5. Daarboven antwoordt de API met status 429 en geeft de wachttijd in Retry-After. Alle limieten staan in Limieten.

Ja, voor bedrijfsprofielen, persoonsprofielen, zoeken en documenten. Stuur een eigen waarde mee in de header Idempotency-Key. Herhaal je de aanvraag binnen 24 uur met dezelfde sleutel en dezelfde parameters, dan kost ze niets.

Ja. Onder Account › API-sleutels maak je extra sleutels aan, bijvoorbeeld één per applicatie. Verwijder je een sleutel, dan is die meteen ongeldig. Alle sleutels delen het saldo van je account.