API-Referenz

Endpunkte

Methode	Pfad	Auth	Zweck
POST	/v1/verifications	API-Key	Prüfung starten (min_age: 16 oder 18, reference optional)
GET	/v1/verifications/{id}	API-Key	Ergebnis abfragen
GET	/v1/webhook-deliveries	API-Key	letzte 20 Webhook-Zustellungen
GET	/v1/client/verifications/{id}	X-Client-Secret	Status für das Widget
GET	/v1/health	–	Betriebsstatus

Die interaktive Referenz mit allen Feldern finden Sie unter api.sigillo-id.ch/docs.

Status

status	Bedeutung	age_verified
pending	wartet auf die Kundin	null
verified	Mindestalter bestätigt	true
rejected	nicht bestanden, siehe reason	false
expired	nach 15 Minuten nicht abgeschlossen	null

reason bei rejected: age_requirement_not_met (zu jung) oder wallet_error:<code> (z. B. in der App abgebrochen).

Fehler

{ "error": { "code": "unauthorized", "message": "API-Key ungültig oder deaktiviert" } }

HTTP	code	Bedeutung
401	unauthorized	Key fehlt, ist falsch oder deaktiviert
404	not_found	Prüfung unbekannt oder gehört einem anderen Shop
422	–	ungültige Eingabe, z. B. min_age nicht 16 oder 18
429	rate_limited	max. 60 neue Prüfungen pro Minute; Retry-After beachten
502	verifier_unavailable	Prüfdienst kurz nicht erreichbar

Datenschutz

Sigillo speichert pro Prüfung nur Status, Mindestalter, Zeitpunkte und Ihre Referenz. Personendaten aus der e-ID erhalten wir nicht.