Änderungsprotokoll

Die API ist versioniert (/v1). Innerhalb von v1 ändern wir nur additiv: neue Endpunkte, neue optionale Felder, neue Ereignisse. Entfernen oder Umbenennen gibt es nur mit einer neuen Version und vorheriger Ankündigung hier.

11.10.2026: Sicherheitsüberarbeitung vor dem Start

• Webhooks melden nur noch Änderungen an Firmen und Domains auf ihrer Beobachtungsliste (GET/POST/DELETE /v1/webhooks/{id}/subscriptions, höchstens 1.000 Einträge je Konto). Webhooks setzen einen Kauf voraus (403 purchase_required).
• Domain-Auffrischung: je Domain höchstens eine in 24 Stunden, je Konto 50 in 24 Stunden (gescheiterte zählen mit); IP-Adressen, Namen ohne öffentliches Suffix und lokale Endungen sind 400.
• GET /v1/domains/{domain} kostet nichts, wenn der Domain keine Firma zugeordnet ist.
• USt-IdNr.: confirmed nur noch mit einer bestätigenden Quelle, die Weitergabe erlaubt (VIES-Prüfungen erscheinen als claimed). Registereinträge, die nur aus nicht weitergebbaren Quellen belegt sind, liefern 404.
• Bulk-Ergebnisse stehen 7 Tage bereit und werden beim Abruf erneut gegen Sperren gefiltert.
• MCP: JSON-RPC-Batches werden abgelehnt (400, -32600); Limits gelten je Werkzeugaufruf.
• Neuer Fehlercode temporarily_unavailable (503), wenn eine Schutzfunktion vorübergehend nicht verfügbar ist.

11.10.2026: erste Version

• REST-API /v1: Firmensuche, Firma, Historie, Beziehungen, Domain, Domain-Refresh, Register, USt-IdNr., LEI, Bulk-Abfrage, Aufträge, Webhooks, Nutzung.
• MCP-Server unter /mcp mit sechs Werkzeugen (search_companies, get_company, lookup_domain, get_company_changes, verify_vat, get_related_companies).
• Credits: 250 gratis im Monat, danach gekauftes Guthaben; Abbuchung nur bei Erfolg.
• Portal unter app.impressum.tech: Anmeldung per Link, Schlüsselverwaltung, Nutzung je Tag, Webhooks, Credit-Pakete (S 10.000 Credits, M 100.000, L 1.000.000) über Stripe, Rechnungen.
• Dokumentation unter docs.impressum.tech mit API-Referenz aus der OpenAPI-Beschreibung.