firmenwebseiten.at

Firmenprüfung API

Starten Sie quellenbasierte Firmenprüfungen per REST API und rufen Sie Reports mit Quellenstatus, Identitätsplausibilität und Warnsignalen ab. Der Confidence Score ist kein Bonitätswert.

Web-Tool öffnenAPI-Zugang anfragen
Auth

Nutzen Sie einen API-Key mit den Scopes company-check:write und company-check:read.

Idempotent

Senden Sie einen Idempotency-Key, damit Wiederholungen keine zweite Prüfung abrechnen.

Asynchron

Prüfungen werden eingereiht. Lesen Sie den Report per GET, bis status completed ist.

Prüfung starten
POST /api/v1/company-checks
Authorization: Bearer fw_...
Idempotency-Key: kunde-123
Content-Type: application/json

{
  "name": "Muster GmbH",
  "address": {
    "street": "Beispielgasse 1",
    "postalCode": "1010",
    "city": "Wien",
    "country": "AT"
  },
  "website": "https://www.muster.at",
  "uidNumber": "ATU12345678",
  "companyRegisterNumber": "FN 123456a",
  "gisaNumber": "12345678",
  "personName": "Max Muster",
  "depth": "official"
}
Antwort
{
  "id": "chk_...",
  "status": "queued",
  "depth": "official",
  "creditsReserved": 5,
  "creditBalance": 42
}
Report abrufen
GET /api/v1/company-checks/chk_...
Authorization: Bearer fw_...

{
  "id": "chk_...",
  "status": "completed",
  "resultStatus": "likely",
  "confidenceScore": 74,
  "sources": [
    {
      "source": "gisa",
      "status": "match",
      "registerStatus": "verified",
      "matchedName": "Muster GmbH",
      "matchedAddress": "Beispielgasse 1, 1010, Wien",
      "matchedIds": {
        "gisaNumber": "12345678",
        "companyRegisterNumber": "FN 123456a"
      },
      "evidence": {
        "tradeRegisterStatus": "verified",
        "candidates": 1
      },
      "errorCode": null,
      "errorMessage": null
    },
    {
      "source": "firmenbuch",
      "status": "match",
      "registerStatus": "verified",
      "matchedName": "Muster GmbH",
      "matchedIds": {
        "companyRegisterNumber": "FN 123456 a"
      },
      "evidence": {
        "documentScope": "Kurzinformation",
        "attribution": "Republik Österreich vertreten durch das BMJ",
        "license": "CC BY 4.0",
        "transformation": "Für firmenwebseiten.at normalisierte und mit eigenen Daten angereicherte Zusammenfassung."
      }
    },
    {
      "source": "edikte",
      "status": "no_match",
      "scoreImpact": 0,
      "evidence": {
        "activeMatches": 0,
        "queryScope": "Offenkundige Zahlungsunfähigkeit, exakte Firmenbuchnummer",
        "attribution": "Republik Österreich vertreten durch das BMJ",
        "license": "CC BY 4.0"
      }
    }
  ]
}

Amtliche BMJ-Quellen

Die Prüftiefen official und compliance fragen die Firmenbuch-Kurzinformation sowie die Ediktsdatei „Offenkundige Zahlungsunfähigkeit“ ausschließlich über eine exakte Firmenbuchnummer ab.deep enthält nur die Ediktsdatei; standard keine der beiden BMJ-Quellen.

Firmenwebseiten.at liefert normalisierte und mit eigenen Signalen angereicherte Zusammenfassungen, keine Rohdaten, Urkunden oder Personensuchen. Ein Ediktstreffer ist ein Warnsignal und verändert den Identitätsplausibilitäts-Score nicht automatisch.

Quelle: Republik Österreich vertreten durch das BMJ. Die Weiterverwendung erfolgt nach den JustizOnline-IWG-Nutzungsbedingungen und ergänzend unter CC BY 4.0.

Endpunkte

POST/api/v1/company-checksNeue Firmenprüfung einreihen.
GET/api/v1/company-checksEigene Firmenprüfungen listen.
GET/api/v1/company-checks/:idStatus und Report abrufen.
Siehe auch: Sichtbarkeits-Check API und der Tools-Überblick.