firmenwebseiten.at

Firmenprüfung API

Starten Sie quellenbasierte Firmenprüfungen per REST API und rufen Sie Reports mit Quellenstatus, Confidence Score und Warnsignalen ab.

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": "standard"
}
Antwort
{
  "id": "chk_...",
  "status": "queued",
  "depth": "standard",
  "creditsReserved": 1,
  "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": "google",
      "status": "match"
    }
  ]
}

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.