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

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.