Credits und Preise
Jeder Aufruf kostet eine feste Zahl Credits. Abgebucht wird nur bei Erfolg (200 oder 201). Antworten mit 404, 4xx oder 5xx kosten nichts, ebenso eine Antwort 202, die erst bei Fertigstellung eines Auftrags abgerechnet wird.
Kosten je Endpunkt
| Methode | Pfad | Credits | Abrechnung |
|---|---|---|---|
GET | /v1/companies/search | 1 | je Ergebnisseite; 20 Treffer je Seite; keine Personensuche |
GET | /v1/companies/{id} | 1 | je erfolgreichem Aufruf |
GET | /v1/companies/{id}/history | 1 | je erfolgreichem Aufruf |
GET | /v1/companies/{id}/relations | 2 | je erfolgreichem Aufruf |
GET | /v1/domains/{domain} | 1 | je erfolgreichem Aufruf |
POST | /v1/domains/{domain}/refresh | 5 | je erfolgreichem Aufruf; 202 + Job, Abbuchung bei Fertigstellung |
GET | /v1/registers/{country}/{court}/{number} | 1 | je erfolgreichem Aufruf; bei Nichtfund 202 und gedrosselter Registerabruf |
GET | /v1/vat/{id} | 1 | je erfolgreichem Aufruf |
GET | /v1/lei/{lei} | 1 | je erfolgreichem Aufruf |
POST | /v1/bulk/domains | 1 | je Treffer; NDJSON, höchstens 10.000 Zeilen |
GET | /v1/jobs/{id} | 0 | je erfolgreichem Aufruf |
GET | /v1/jobs/{id}/result | 0 | je erfolgreichem Aufruf; Ergebnis eines Bulk-Auftrags als NDJSON |
POST | /v1/webhooks | 0 | je erfolgreichem Aufruf |
GET | /v1/webhooks | 0 | je erfolgreichem Aufruf |
DELETE | /v1/webhooks/{id} | 0 | je erfolgreichem Aufruf |
GET | /v1/webhooks/{id}/subscriptions | 0 | je erfolgreichem Aufruf |
POST | /v1/webhooks/{id}/subscriptions | 0 | je erfolgreichem Aufruf; höchstens 100 Einträge je Aufruf, 1.000 je Konto |
DELETE | /v1/webhooks/{id}/subscriptions | 0 | je erfolgreichem Aufruf |
GET | /v1/usage | 0 | je erfolgreichem Aufruf |
Jede Antwort mit Schlüssel trägt den Kopf X-Credits-Remaining mit dem Stand nach der Anfrage.
Gratiskontingent
Jedes Konto hat 250 Credits je Kalendermonat (UTC). Sie werden zuerst verbraucht und setzen sich zum Monatsersten
zurück. Nicht genutzte Gratis-Credits verfallen am Monatsende. Das Gratiskontingent gibt es einmal je Postfach:
Weitere Konten mit Varianten derselben Adresse (name+zusatz@…, bei Gmail auch mit Punkten) haben keins, und wer sein
Konto löscht und neu anlegt, startet im selben Monat mit dem bisherigen Verbrauch.
Pakete
Gekaufte Credits verfallen nicht. Der Kauf ist eine Einmalzahlung über Stripe, kein Abo.
| Paket | Credits | Preis | je Credit |
|---|---|---|---|
| S | 10.000 | 19 € | 0,19 ct |
| M | 100.000 | 99 € | 0,099 ct |
| L | 1.000.000 | 490 € | 0,049 ct |
Die Rechnung stellt Stripe aus; du findest sie im Portal unter „Rechnungen“. Preise in Euro, inklusive gesetzlicher Umsatzsteuer, soweit sie anfällt.
Wird eine Zahlung erstattet, buchen wir die Credits anteilig wieder ab (soweit noch vorhanden). Bei einer Rückbuchung (Chargeback) buchen wir die Credits des Kaufs ab und sperren das Konto bis zur Klärung.
Wie abgebucht wird
Die API reserviert die Credits vor der Ausführung und nimmt sie bei einer Fehlerantwort sofort zurück. Parallele
Anfragen können dein Guthaben deshalb nie ins Minus ziehen. Reicht das Guthaben nicht, kommt
402 insufficient_credits mit dem verbleibenden Stand in der Meldung.
Aufträge (POST /v1/domains/{domain}/refresh, POST /v1/bulk/domains) antworten mit 202 und eine Auftrags-ID.
Abgerechnet wird bei Fertigstellung; scheitert der Auftrag, bekommst du alles zurück. Den Stand liest du mit
GET /v1/jobs/{id}. Ein gescheiterter Auftrag zählt trotzdem auf das Tageskontingent der Auffrischungen. Das
Ergebnis eines Bulk-Auftrags (GET /v1/jobs/{id}/result) steht 7 Tage bereit; seither gesperrte Domains und Firmen
fallen beim Abruf heraus.
GET /v1/domains/{domain} kostet nichts, wenn die Domain bekannt ist, aber keiner Firma zugeordnet ist.
Stand und Verbrauch je Tag und Endpunkt siehst du im Portal oder über GET /v1/usage.