Fahrzeugschein API für Entwickler

Ein POST, ein fertiger Datensatz: Sie schicken das Foto oder PDF einer Zulassungsbescheinigung Teil I an die Fahrzeugschein API und bekommen in der Regel nach ein bis zwei Sekunden JSON zurück — bis zu 65 Felder, jedes mit Wert, Sicherheitswert und Fundstelle im Bild. Entwickler brauchen vier Zeilen curl und kein Vertriebsgespräch. Betrieben wird der Dienst von der Picsure GmbH in Hamburg, verarbeitet wird in Deutschland und der EU.

Ein Aufruf der Fahrzeugschein API, ein fertiger Datensatz

Ein Aufruf verarbeitet ein Dokument. Die Antwort enthält immer den vollständigen Feldkatalog — auch die Felder, die auf dem vorliegenden Schein gar nicht gedruckt sind; die kommen als `null` zurück statt als fehlender Schlüssel. Ihr Code greift also fest auf Schlüssel zu, statt jede Antwort auf Vollständigkeit abzuklopfen.

Bis zu 65 Felder tragen einen gelesenen Wert, vom Kennzeichen über die Fahrzeug-Identifizierungsnummer bis zu den technischen Angaben; wie viele es werden, entscheidet das Dokument. Jedes erkannte Feld bringt den Wert, einen Sicherheitswert zwischen 0 und 1 und die Fundstelle als Pixelrechteck mit, auf Wunsch den Bildausschnitt dazu. Ihre Sachbearbeitung sieht damit zu jedem Wert, wie sicher er gelesen wurde und wo er im Original steht — welche Angaben zusammenkommen, zeigt die Übersicht zur Zulassungsbescheinigung.

Die erste Anfrage steht in wenigen Minuten

curl -X POST https://api.fahrzeugschein24.de/v1/extract \
  -H "Authorization: Bearer $FZ24_API_KEY" \
  -F "file=@fahrzeugschein.jpg" \
  -F "services=extraction" \
  -F "include_field_images=true"

Die Antwort: Wert, Sicherheitswert, Fundstelle

{
  "fields": {
    "registrationNumber": { "value": "M SN 1234 E",       "confidence": 0.99, "bbox": [412, 268, 668, 318] },
    "vin":                { "value": "WVWZZZ1JZXW000001", "confidence": 0.96, "bbox": [770, 512, 1290, 566] },
    "field_3":            { "value": "6",                 "confidence": 0.94, "bbox": [1302, 512, 1348, 566] },
    "hsn":                { "value": "0603",              "confidence": 0.98, "bbox": [402, 690, 512, 736] },
    "tsn":                { "value": "AKD",               "confidence": 0.97, "bbox": [560, 690, 668, 736] },
    "ez_string":          { "value": "14.03.2019",        "confidence": 0.97, "bbox": [412, 604, 604, 652] },
    "ez":                 { "value": "2019-03-14",        "confidence": 0.97, "bbox": [412, 604, 604, 652] },
    "field_10":           { "value": "0004",              "confidence": 0.95, "bbox": [980, 812, 1064, 858] },
    "field_21":           null
  },
  "vin_valid": true,
  "image_width": 2480,
  "image_height": 1748,
  "services": ["extraction"]
}

Je Aufruf entscheiden, wie viel zurückkommt

Vier Details, die Ihre Integration gleich beim ersten Anlauf richtig machen

Kontingente, die mitwachsen, und ein Vertrag, der bleibt

Zwei Grenzen, unabhängig voneinander: Aufrufe je Minute, von 10 im Free-Tarif bis 150 im Enterprise-Tarif, und Extraktionen im Monat — 15 im Free, 100 im Starter, 1.000 im Business, 5.000 im Scale, 20.000 im Enterprise. Free stoppt hart, aus einem Test entsteht also keine Rechnung. In den bezahlten Tarifen läuft die Verarbeitung über das Kontingent hinaus weiter und wird je zusätzlicher Extraktion abgerechnet, von 0,20 € im Starter bis 0,11 € im Enterprise (netto, zzgl. USt.). Eine Lastspitze ist damit eine Frage der Abrechnung, nicht des Tarifwechsels; alle Stufen stehen in der Tarifübersicht.

Der Endpunkt ist versioniert: /v1/extract bleibt /v1/extract, brechende Änderungen bekommen eine eigene Version. Jede Antwort nennt die verarbeitende Version und den Stand Ihres Ratenlimits, jede Ablehnung einen stabilen Fehlercode, auf den Sie verzweigen statt auf einen Fehlertext. Webhooks, Signaturprüfung und die vollständige Fehlerliste stehen in der API-Dokumentation; Verarbeitung und Speicherung erklärt die Seite Sicherheit.

Häufige Fragen zur Fahrzeugschein API

Weitere Informationen zum Fahrzeugschein