{"openapi":"3.0.3","info":{"description":"Steigern Sie das Vertrauen in Ihre Plattform und deren Sicherheit mit der umfassenden „Validation & Identity API Suite“ von TRUST. Sie bietet eine sofortige und präzise Validierung von E-Mail-Adressen, Telefonnummern, URLs, IP-Adressen und IBANs und stellt so sicher, dass Ihre Nutzerdaten vom ersten Tag an sauber und verwertbar sind. Alle Endpunkte nutzen ein solides, fehlertolerantes asynchrones Warteschlangensystem: Senden Sie Ihre Anfrage ab und erhalten Sie Aktualisierungen über Webhooks (Callbacks) oder fragen Sie die Ressource einfach ab. Darüber hinaus verfügt die Suite über eine robuste Identitäts- und Dokumentenüberprüfung, die KI-gestützte, automatisierte Überprüfungen ermöglicht.","version":"3.0.3","title":"Trust Validation & Identity API","termsOfService":"https://openapi.it/en/terms-and-conditions","contact":{"url":"https://openapi.it/en/support","name":"Support"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}},"servers":[{"url":"https://trust.openapi.com","description":"Produktion"},{"url":"https://test.trust.openapi.com","description":"Sandbox"}],"tags":[{"name":"HLR","description":"Abfrage des „Home Location Register“ zur Überprüfung von Mobiltelefonnummern"},{"name":"Email","description":"E-Mail-Validierungsdienste"},{"name":"IP & Proxy","description":"Dienste zur Überprüfung von IP-Adressen und zur Proxy-Erkennung"},{"name":"URL","description":"Dienste zur URL-Prüfung und Bedrohungsanalyse"},{"name":"Identity Verification","description":"Dienstleistungen zur Identitätsprüfung"},{"name":"IBAN Verification","description":"IBAN-Validierung, Extraktion von Bankdaten und SEPA-Erreichbarkeitsdienste"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"skipParam":{"name":"skip","in":"query","description":"Anzahl der Datensätze, die bei der Paginierung übersprungen werden sollen.","required":false,"schema":{"type":"integer","default":0}},"limitParam":{"name":"limit","in":"query","description":"Maximale Anzahl der zurückzugebenden Datensätze (max. 100).","required":false,"schema":{"type":"integer","default":100,"maximum":100}},"stateQueryParam":{"name":"state","in":"query","description":"Ergebnisse nach ihrem Bearbeitungsstatus filtern.","required":false,"schema":{"type":"string","enum":["NEW","WAIT","DONE"]}}},"schemas":{"Callback":{"type":"object","description":"Dies ist unser standardisiertes OpenAPI-Callback-System. Es ermöglicht die Konfiguration von Parametern für den Empfang von Benachrichtigungen über Statusaktualisierungen asynchroner Anfragen an diesen Endpunkt.","required":["url"],"properties":{"method":{"type":"string","description":"Geben Sie die Callback-Methode an. Bei der Einstellung „POST“ wird eine standardmäßige HTTP-POST-Anfrage initiiert, wobei der Content-Type-Header auf „application/x-www-form-urlencoded“ gesetzt ist. Die JSON-Daten werden in ein Schlüssel-Wert-Paar namens „data“ (anpassbar über den Parameter „field“) im Anfragetext kodiert. Wenn die Methode auf „JSON“ gesetzt ist, wird eine direkte HTTP-POST-Anfrage gesendet, wobei der Content-Type-Header auf „application/json“ gesetzt ist. Die JSON-Rohdaten werden ohne jegliche Kodierung direkt in den Anfragetext eingefügt.","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","description":"Dieser Parameter funktioniert in Verbindung mit dem Parameter „method“, der auf „POST“ gesetzt ist. Wenn er als Zeichenfolge angegeben wird, legt er den Namen des Parameters fest, der in der POST-Anfrage gesendet wird.","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"In diesen Parameter muss eine gültige URL eingegeben werden, die POST-Anfragen verarbeiten kann. Bei Endpunkten, die eine Authentifizierung erfordern, kann der Parameter „headers“ verwendet werden, um „basic auth“ oder „bearer auth“ anzugeben. Das maximale Timeout beträgt 30 Sekunden. Wenn „retry“ gesetzt ist, führt das System bis zu „retry“ Mal einen erneuten Versuch durch, bis ein Statuscode 200 empfangen wird.","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"Die maximale Anzahl der Versuche wird durch den Parameter „retry“ festgelegt. Wird die maximale Anzahl der Versuche erreicht, ohne dass ein erfolgreicher Statuscode (z. B. 200 OK) zurückgegeben wird, gilt die Anfrage als endgültig fehlgeschlagen. Oft wird zwischen den Versuchen ein Zeitintervall eingefügt, um eine Überlastung des Servers zu vermeiden. Dieses Intervall kann sich mit jedem Versuch exponentiell verlängern, um die Auswirkungen auf einen überlasteten Server zu verringern. Der Parameter „retry“ ist so konfiguriert, dass die Anfrage nur bei bestimmten Statuscodes erneut versucht wird, typischerweise bei solchen, die auf vorübergehende Fehler (z. B. 502, 503) oder Netzwerkprobleme hinweisen.","example":3,"minimum":0,"maximum":5,"default":0},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"Eine Sammlung von HTTP-Headern, die mit der Anfrage gesendet werden sollen. Jeder Header wird als Schlüssel-Wert-Paar definiert. Header können für verschiedene Zwecke verwendet werden, darunter Authentifizierung, Inhaltsaushandlung und benutzerdefinierte Metadaten.","example":{"session_id":"9834r5fh589494"}},"custom":{"type":"object","description":"Dieses Objekt kann mit beliebigen zusätzlichen Daten gefüllt werden, die Sie in die Callback-Antwort aufnehmen möchten. Auf diese Daten können Sie über den Parameter „custom“ der Callback-Funktion zugreifen. Auf diese Weise können Sie alle relevanten Informationen speichern und abrufen, die Sie für Ihre Anwendung benötigen.","example":{"my_custom_id":"123456789"}}}},"GenericResponseWrapper":{"type":"object","properties":{"success":{"type":"boolean","example":true},"message":{"type":"string","example":"Success"},"error":{"type":"string","nullable":true,"example":null}}},"mobile-start":{"type":"object","properties":{"id":{"type":"string","example":"66d9e92216065fa37f3c9841"},"state":{"type":"string","enum":["NEW","WAIT","DONE"],"description":"Gibt den Status der Anfrage an. „DONE“ bedeutet, dass die HLR-Netzwerkprüfung abgeschlossen ist.","example":"DONE"},"status":{"type":"string","enum":["valid","invalid","unknown"],"description":"Die TATSÄCHLICHE Netzgültigkeit der Telefonnummer anhand einer HLR-Abfrage. Dies ist der entscheidende Parameter, um zu überprüfen, ob die Nummer existiert und aktiv ist. Der Wert bleibt „unbekannt“, bis der „Status“ auf „DONE“ wechselt.","example":"valid"},"requestedNumber":{"type":"string","example":"00393939989747"},"formattedNumber":{"type":"string","example":"+393939989747"},"numberType":{"type":"string","example":"MOBILE"},"isPossible":{"type":"boolean","description":"[NUR FORMALE PRÜFUNG] Gibt an, ob die Nummernlänge und das Präfix für die Region theoretisch möglich sind. Das bedeutet NICHT, dass die Nummer tatsächlich existiert.","example":true},"isValid":{"type":"boolean","description":"[NUR FORMALE PRÜFUNG] Zeigt an, ob die Nummer der für die Region gültigen Syntax bzw. dem regulären Ausdruck entspricht. WARNUNG: Eine Nummer kann den Wert „isValid: true“ haben, aber tatsächlich nicht erreichbar oder nicht existent sein. Verlassen Sie sich für eine echte Netzwerkvalidierung auf das Feld „status“.","example":true},"regionCode":{"type":"string","example":"IT"},"isValidNumberForRegion":{"type":"boolean","example":true},"network":{"type":"string","example":"MNO - Vodafone Italy"},"originalNetwork":{"type":"string","example":"MNO - TIM"},"roaming":{"type":"boolean","example":false},"ported":{"type":"boolean","example":true},"country":{"type":"string","example":"Italy"},"countryPrefix":{"type":"string","example":"39"},"details":{"type":"string","description":"Weitere Netzwerkinformationen des Anbieters (z. B. DELIVERED_TO_HANDSET).","example":"DELIVERED_TO_HANDSET"},"createdAt":{"type":"string","format":"date-time","example":"2026-06-08T10:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-06-08T10:00:05Z"}}},"email-start":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Kennung für die Validierungsanfrage, die bei der Erstellung der Anfrage zurückgegeben wird.","example":"eml_77e9e92216065fa37f3c9842","readOnly":true},"state":{"type":"string","description":"Verarbeitungsstatus der Validierungsanfrage. „DONE“ bedeutet, dass die Validierung abgeschlossen ist und die Ergebnisse vorliegen.","enum":["NEW","WAIT","DONE"],"example":"DONE"},"requestedEmail":{"type":"string","format":"email","description":"Die ursprüngliche E-Mail-Adresse, wie sie vom Kunden in der Anfrage angegeben wurde.","example":" Test.User@EXAMPLE.COM "},"email":{"type":"string","format":"email","description":"Die E-Mail-Adresse, die verarbeitet wurde, möglicherweise nach einer ersten Bereinigung (z. B. Entfernen von Leerzeichen).","example":"Test.User@EXAMPLE.COM"},"emailNormalized":{"type":"string","format":"email","description":"Die normalisierte Version der E-Mail-Adresse, die zur Validierung verwendet wird (z. B. in Kleinbuchstaben).","example":"test.user@example.com"},"status":{"type":"string","description":"Der allgemeine Validierungsstatus der E-Mail-Adresse. Wenn die E-Mail-Adresse eine bestimmte Rolle hat (z. B. „Antispam“, „geschützt“, „Einwegadresse“ oder „CatchAll“), wird der Status immer als „riskant“ eingestuft. Der Status „ungültig“ wird nur zurückgegeben, wenn die Adresse technisch ungültig ist (falsches Format, nicht vorhandene Domain/Adresse oder in Fällen wie Greylisting). Schließlich wird der Status „unbekannt“ zurückgegeben, wenn der Anbieter des Remote-Servers nicht rechtzeitig geantwortet hat. ","enum":["valid","invalid","risky","unknown"],"example":"valid"},"validSpf":{"type":"boolean","description":"Gibt an, ob der SPF-Eintrag der Domain gültig ist und E-Mails von den erkannten Mailservern zulässt.","example":true},"spfDetails":{"$ref":"#/components/schemas/SpfDetails"},"validDmarc":{"type":"boolean","description":"Gibt an, ob die Domain über einen gültigen DMARC-Eintrag verfügt und die Richtlinie erfüllt ist.","example":true},"dmarcDetails":{"$ref":"#/components/schemas/DmarcDetails"},"details":{"type":"string","description":"Ein genauerer Code oder eine genauere Meldung, die den Teilstatus der Validierung beschreibt (z. B. „mailbox_valid“, „domain_invalid“, „smtp_error“).","example":"mailbox_valid","nullable":true},"free":{"type":"boolean","description":"Gibt an, ob die E-Mail-Adresse von einem kostenlosen E-Mail-Anbieter stammt (z. B. Gmail, Outlook.com).","example":true},"role":{"type":"boolean","description":"Gibt an, ob es sich bei der E-Mail-Adresse um ein rollenbasiertes Konto handelt (z. B. admin@, support@, info@).","example":false},"disposable":{"type":"boolean","description":"Gibt an, ob die E-Mail-Adresse von einem bekannten Anbieter von Wegwerf-E-Mail-Adressen stammt.","example":false},"catchAll":{"type":"boolean","description":"Gibt an, ob die E-Mail-Domäne als Catch-All konfiguriert ist.","example":false,"nullable":true},"hasAntispam":{"type":"boolean","description":"Gibt an, ob der Mailserver für die Domain Antispam-Systeme erkannt hat.","example":true,"nullable":true},"mailboxFull":{"type":"boolean","description":"Gibt an, ob das Postfach als voll gemeldet wird (sofern feststellbar).","example":false,"nullable":true},"didYouMean":{"type":"string","format":"email","description":"Ein Korrekturvorschlag, falls in der E-Mail-Domain ein häufiger Tippfehler entdeckt wird.","example":"user@gmail.com","nullable":true},"createdAt":{"type":"string","format":"date-time","description":"Zeitstempel, der angibt, wann die Validierungsanfrage erstellt wurde.","example":"2025-05-27T10:00:00Z","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Zeitstempel, der angibt, wann die Validierungsanfrage zuletzt aktualisiert wurde.","example":"2025-05-27T10:00:05Z","readOnly":true}}},"SpfFormalValidity":{"type":"object","description":"Einzelheiten zur formalen Gültigkeit des SPF-Eintrags.","properties":{"startsWithVspf1":{"type":"boolean","description":"Gibt an, ob der Datensatz mit „v=spf1“ startet."},"hasValidAllMechanism":{"type":"boolean","description":"Gibt an, ob ein gültiger „all“-Mechanismus vorhanden ist."},"dnsMechanismLookupCount":{"type":"integer","description":"Anzahl der DNS-Abfragen für Mechanismen."},"maxDnsMechanismLookups":{"type":"integer","description":"Maximal zulässige Anzahl von DNS-Abfragen für Mechanismen."},"voidLookupCount":{"type":"integer","description":"Anzahl der erfolglosen DNS-Abfragen."},"maxVoidLookups":{"type":"integer","description":"Maximal zulässige Anzahl nicht erfolgreicher DNS-Abfragen."},"hasRedirectModifier":{"type":"boolean","description":"Gibt an, ob ein „redirect“-Modifikator vorhanden ist."},"redirectDomain":{"type":"string","nullable":true,"description":"Die im Modifikator „redirect“ angegebene Domain.","example":"_spf.example.com"},"syntaxErrors":{"type":"array","items":{"type":"string"},"description":"Liste der gefundenen Syntax-ERRORS.","example":["Unknown mechanism: xyz"]},"warnings":{"type":"array","items":{"type":"string"},"description":"Liste der während der Analyse generierten Warnungen.","example":["PTR mechanism used, which is discouraged."]},"explanationDomain":{"type":"string","nullable":true,"description":"Die im Modifikator „exp“ angegebene Domäne.","example":"exp.example.com"}}},"SpfMechanism":{"type":"object","description":"Einzelheiten zu einem analysierten SPF-Mechanismus. Die Struktur kann je nach Mechanismusart variieren.","properties":{"term":{"type":"string","description":"Der ursprüngliche Begriff für den Mechanismus.","example":"+mx"},"mechanism":{"type":"string","description":"Die Art des Mechanismus (z. B. „ip4“, „include“, „a“).","example":"mx"},"value":{"type":"string","nullable":true,"description":"Der mit dem Mechanismus verbundene Wert.","example":"mail.example.com"},"qualifier":{"type":"string","description":"Der Qualifizierer des Mechanismus (+, -, ~, ?).","example":"+"},"lookupCost":{"type":"integer","description":"Der Aufwand für die DNS-Abfrage dieses Mechanismus.","example":1},"isVoidLookup":{"type":"boolean","description":"Gibt an, ob dieser Mechanismus zu einer ungültigen Suche geführt hat."},"ipsFound":{"type":"array","items":{"type":"string"},"description":"IP-Adressen, die speziell über diesen Mechanismus ermittelt wurden.","example":["192.0.2.1","2001:db8::1"]},"effectiveResultIfMatched":{"type":"string","description":"Das SPF-Ergebnis, falls dieser Mechanismus übereinstimmen würde (PASS, FAIL usw.).","example":"PASS"},"includedReport":{"$ref":"#/components/schemas/SpfDetails"},"redirectedReport":{"$ref":"#/components/schemas/SpfDetails"}},"additionalProperties":true},"SpfAllMechanismDetails":{"type":"object","nullable":true,"description":"Einzelheiten zum „all“-Mechanismus, sofern vorhanden.","properties":{"term":{"type":"string","example":"-all"},"qualifier":{"type":"string","example":"-"},"result":{"type":"string","example":"FAIL"}}},"SpfCollectedIpAddresses":{"type":"object","description":"Bei der SPF-Analyse erfasste IP-Adressen.","properties":{"ip4":{"type":"array","items":{"type":"string"},"example":["192.0.2.0/24"]},"ip6":{"type":"array","items":{"type":"string"},"example":["2001:db8:1234::/48"]},"fromA":{"type":"array","items":{"type":"string"},"example":["203.0.113.5"]},"fromMx":{"type":"array","items":{"type":"string"},"example":["203.0.113.10"]}}},"SpfSummary":{"type":"object","description":"Zusammenfassung der SPF-Analyse.","properties":{"totalDnsMechanismLookupsUsed":{"type":"integer","example":3},"finalProcessingResult":{"type":"string","description":"Endgültiges Verarbeitungsergebnis des SPF-Eintrags (z. B. NEUTRAL, PERMERROR, NONE).","example":"FAIL"},"evaluationLog":{"type":"array","items":{"type":"string"},"example":["Mechanism 'mx' matched.","Mechanism '-all' encountered."]}}},"SpfDetails":{"type":"object","description":"Ausführliche Informationen zur Analyse des SPF-Eintrags.","properties":{"domain":{"type":"string","example":"example.com"},"dnsServerUsed":{"type":"string","nullable":true,"description":"Für diese spezifische SPF-Analyse verwendeter DNS-Server.","example":"8.8.8.8"},"queriedDnsForTxt":{"type":"boolean"},"selectedSpfRecord":{"type":"string","nullable":true,"example":"v=spf1 mx -all"},"formalValidity":{"$ref":"#/components/schemas/SpfFormalValidity"},"parsedMechanisms":{"type":"array","items":{"$ref":"#/components/schemas/SpfMechanism"}},"allMechanismDetails":{"$ref":"#/components/schemas/SpfAllMechanismDetails"},"collectedIpAddresses":{"$ref":"#/components/schemas/SpfCollectedIpAddresses"},"summary":{"$ref":"#/components/schemas/SpfSummary"}}},"DmarcDetails":{"type":"object","description":"Ausführliche Informationen zur Analyse des DMARC-Eintrags.","properties":{"recordFound":{"type":"boolean"},"record":{"type":"string","nullable":true,"example":"v=DMARC1; p=reject; rua=mailto:dmarc@example.com"},"dnsQueryDomain":{"type":"string","example":"_dmarc.example.com"},"dnsServerUsed":{"type":"string","nullable":true,"description":"Für diese spezifische DMARC-Analyse verwendeter DNS-Server.","example":"1.1.1.1"},"policy":{"type":"string","nullable":true,"enum":["none","quarantine","reject"],"example":"reject"},"subdomainPolicy":{"type":"string","nullable":true,"enum":["none","quarantine","reject"],"example":"none"},"alignmentDkim":{"type":"string","enum":["r","s"],"example":"r"},"alignmentSpf":{"type":"string","enum":["r","s"],"example":"r"},"percentage":{"type":"integer","example":100},"reportingUrisAggregate":{"type":"array","items":{"type":"string"},"example":["mailto:aggrep@example.com"]},"reportingUrisFailure":{"type":"array","items":{"type":"string"},"example":["mailto:authfail@example.com"]},"failureOptions":{"type":"array","items":{"type":"string"},"example":["0","1","d","s"]},"errors":{"type":"array","items":{"type":"string"},"example":["Invalid tag: xyz=abc"]},"warnings":{"type":"array","items":{"type":"string"},"example":["pct tag not found, defaulting to 100."]}}},"email-advanced":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Kennung für diese Validierungsanfrage.","example":"68824e7a933ef7b3a5017d38"},"email":{"type":"string","description":"Die angeforderte E-Mail-Adresse.","example":"example@gmail.com"},"spfDetails":{"$ref":"#/components/schemas/SpfDetails"},"dmarcDetails":{"$ref":"#/components/schemas/DmarcDetails"},"createdAt":{"type":"string","format":"date-time","description":"Zeitstempel, der angibt, wann die Validierungsanfrage erstellt wurde.","example":"2025-07-25T12:44:46+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"Zeitstempel, der angibt, wann die Validierungsanfrage zuletzt aktualisiert wurde.","example":"2025-07-25T12:44:46+00:00"},"state":{"type":"string","description":"Verarbeitungsstatus der Anfrage. „DONE“ bedeutet, dass die Verarbeitung abgeschlossen ist.","example":"DONE"},"message":{"type":"string","description":"Eine allgemeine Statusmeldung, in der Regel „Erfolgreich.“, die jedoch auch weitere Informationen zur Bearbeitung der Anfrage oder eine Meldung zum Fehler enthalten kann.","example":"Success."},"success":{"type":"boolean","description":"Wurde die Validierungsanforderung erfolgreich ausgeführt?","example":true},"valid":{"type":"boolean","description":"Scheint diese E-Mail-Adresse gültig zu sein?","example":true},"disposable":{"type":"boolean","description":"Besteht der Verdacht, dass diese E-Mail von einem temporären oder Wegwerf-E-Mail-Dienst stammt? Diese werden in der Regel mit Betrügern und Scammern in Verbindung gebracht.","example":false},"smtpScore":{"type":"integer","description":"Gültigkeitsbewertung der SMTP-Konfiguration des E-Mail-Servers. Bereich: -1 bis 3. Werte über -1 können mit einer gültigen E-Mail-Adresse in Verbindung stehen. -1 = ungültige E-Mail-Adresse, 0 = Mailserver existiert, lehnt jedoch alle E-Mails ab, 1 = Mailserver existiert, weist jedoch einen vorübergehenden Fehler auf, 2 = Mailserver existiert und akzeptiert alle E-Mails, 3 = Mailserver existiert und hat die E-Mail-Adresse verifiziert.","example":3},"overallScore":{"type":"integer","description":"Gesamtbewertung der E-Mail-Gültigkeit. Bereich: 0 bis 4. Werte über 1 können auf eine gültige E-Mail-Adresse hindeuten. 0 = ungültige E-Mail-Adresse, 1 = DNS gültig, E-Mail-Server nicht erreichbar, 2 = DNS gültig, vorübergehender Fehler bei der E-Mail-Zustellung, 3 = DNS gültig, akzeptiert alle E-Mails, 4 = DNS gültig, E-Mail-Adresse verifiziert.","example":4},"firstName":{"type":"string","description":"Vermuteter Vorname basierend auf der E-Mail-Adresse. Gibt „CORPORATE“ zurück, wenn der Verdacht besteht, dass es sich bei der E-Mail-Adresse um eine generische Unternehmens-E-Mail-Adresse handelt. Gibt „UNKNOWN“ zurück, wenn der Vorname nicht ermittelt werden konnte.","example":"UNKNOWN"},"generic":{"type":"boolean","description":"Besteht der Verdacht, dass es sich bei dieser E-Mail-Adresse um eine Sammeladresse oder eine gemeinsam genutzte E-Mail-Adresse für eine Domain handelt? (z. B. „admin@“, „webmaster@“, „newsletter@“, „sales@“, „contact@“ usw.)","example":false},"common":{"type":"boolean","description":"Stammt diese E-Mail von einem gängigen kostenlosen E-Mail-Anbieter? (z. B. „gmail.com“, „yahoo.com“, „hotmail.com“ usw.)","example":true},"dnsValid":{"type":"boolean","description":"Verfügt der Hostname der E-Mail über gültige DNS-Einträge? Dies ist ein teilweiser Hinweis auf eine gültige E-Mail-Adresse.","example":true},"honeypot":{"type":"boolean","description":"Wird diese E-Mail-Adresse als „Honeypot“ oder „Spam-Falle“ angesehen? Der Versand von Massen-E-Mails an diese Adressen erhöht das Risiko, dass Sie von großen Internetdienstanbietern auf eine schwarze Liste gesetzt werden und Ihre E-Mails im Spam-Ordner landen.","example":false},"deliverability":{"type":"string","description":"Wie wahrscheinlich ist es, dass diese E-Mail an den Empfänger zugestellt wird und in dessen Postfach landet? Mögliche Werte sind „hoch“, „mittel“ oder „niedrig“.","example":"high"},"frequentComplainer":{"type":"boolean","description":"Gibt an, ob diese E-Mail-Adresse häufig aus Marketing-Verteilern abgemeldet wird oder Spam-Beschwerden meldet.","example":false},"spamTrapScore":{"type":"string","description":"Intelligente Einstufung der Wahrscheinlichkeit, dass es sich bei der E-Mail-Adresse um eine aktive Spam-Falle handelt. Mögliche Werte sind „hoch“, „mittel“, „niedrig“ oder „keine“. Wir empfehlen, E-Mails mit dem Status „hoch“ zu bereinigen, typischerweise bei Werbe-E-Mails. Diese Daten sollen ein genaueres Ergebnis für die Datenpunkte „frequentComplainer“ und „honeypot“ liefern.","example":"none"},"catchAll":{"type":"boolean","description":"Handelt es sich bei dieser E-Mail möglicherweise um eine „Catch-All“-Adresse, bei der der Mailserver alle an sie gesendeten E-Mails als gültig bestätigt? In solchen Fällen lässt sich nur schwer feststellen, ob die Adresse tatsächlich gültig ist, da der E-Mail-Server den Status des Kontos nicht bestätigt.","example":false},"timedOut":{"type":"boolean","description":"Ist die Verbindung zum E-Mail-Dienstanbieter während der Verifizierung abgelaufen? Abfragen, bei denen nach Ablauf der Wartezeit das Ergebnis „gültig“ als „falsch“ zurückgegeben wird, sind höchstwahrscheinlich falsch und sollten nicht als vertrauenswürdig angesehen werden.","example":false},"suspect":{"type":"boolean","description":"Dieser Wert gibt an, ob der Mailserver derzeit einen vorübergehenden Mailserver-ERROR meldet oder ob das E-Mail-Verifizierungssystem die E-Mail-Adresse aufgrund eines fehlgeschlagenen SMTP-Handshakes nicht überprüfen kann. Dieser Status trifft auch auf „Catch-All“-E-Mail-Adressen zu. Ist dieser Wert „true“, besteht der Verdacht, dass das Ergebnis „gültig“ fehlerhaft sein könnte, und es gibt keine Garantie dafür, dass die E-Mail-Adresse tatsächlich gültig ist.","example":false},"recentAbuse":{"type":"boolean","description":"Dieser Wert gibt an, ob für diese E-Mail-Adresse in letzter Zeit ein Missbrauch festgestellt wurde. Unter Missbrauch fallen beispielsweise bestätigte Rückbuchungen, gefälschte Registrierungen, kompromittierte Geräte, gefälschte App-Installationen oder ähnliche böswillige Handlungen innerhalb der letzten Tage.","example":false},"fraudScore":{"type":"integer","description":"Der Gesamt-Betrugswert des Nutzers, der auf der Reputation der E-Mail und dem jüngsten Verhalten basiert. Betrugswerte von ≥ 75 gelten als verdächtig, deuten jedoch nicht zwangsläufig auf Betrug hin.","example":0},"suggestedDomain":{"type":"string","description":"Der Standardwert lautet „N/A“. Gibt an, ob die Domain dieser E-Mail-Adresse tatsächlich auf einen gängigen E-Mail-Dienst korrigiert werden sollte. Dieses Feld ist nützlich, um Tippfehler von Benutzern zu erkennen. Bei einer E-Mail-Adresse mit „gmai.com“ würde beispielsweise „gmail.com“ als vorgeschlagene Domain angezeigt werden.","example":"N/A"},"leaked":{"type":"boolean","description":"War diese E-Mail-Adresse mit einem kürzlich aufgetretenen Datenleck bei einem Drittanbieter in Verbindung? Offengelegte Konten stellen ein Risiko dar, da sie möglicherweise im Zuge eines Datenlecks kompromittiert wurden.","example":false},"sanitizedEmail":{"type":"string","description":"Bereinigte E-Mail-Adresse, bei der alle Aliase und Maskierungen entfernt wurden, wie z. B. mehrere Punkte bei Gmail.com.","example":"example@gmail.com"},"identityData":{"type":"string","description":"Ein Objekt, das erweiterte Identitätsangaben enthält, die aus äußerst zuverlässigen Datenquellen stammen. Es ergänzt Angaben zu Name, Alter sowie zugehörige E-Mail-Adressen, Telefonnummern und Anschriften. Jeder Eintrag steht für eine Person. Jedes Feld kann mehrere Werte enthalten.","nullable":true},"domainAge":{"type":"object","properties":{"human":{"type":"string","example":"30 years ago"},"timestamp":{"type":"integer","example":808286400},"iso":{"type":"string","example":"1995-08-13T00:00:00-04:00"}},"description":"Ein Objekt, das das Alter der Domain in einem für Menschen lesbaren Format sowie ein entsprechendes Datum und einen Zeitstempel im ISO-8601-Format enthält."},"firstSeen":{"type":"object","properties":{"human":{"type":"string","example":"2 years ago"},"timestamp":{"type":"integer","example":1706083391},"iso":{"type":"string","example":"2024-01-24T03:03:11-05:00"}},"description":"Ein Objekt, das den Zeitpunkt enthält, zu dem diese E-Mail zum ersten Mal vom Netzwerk erkannt wurde, und zwar in einem für Menschen lesbaren Format sowie als entsprechendes Datum und Zeitstempel im ISO-8601-Format."},"riskyTld":{"type":"boolean","description":"Weist darauf hin, dass die Domain zu einer risikobehafteten TLD-Endung gehört, die häufig mit Malware, Betrug, Missbrauch oder Phishing in Verbindung gebracht wird.","example":false},"spfRecord":{"type":"boolean","description":"Verfügt die Domain über einen gültigen SPF-Eintrag? (wahr/falsch) Dies deutet darauf hin, dass die Domain über einen gültigen SPF-Eintrag verfügt, was ein gutes Zeichen für eine legitime Domain ist.","example":true},"dmarcRecord":{"type":"boolean","description":"Verfügt die Domain über einen gültigen DMARC-Eintrag? (wahr/falsch) Dies deutet darauf hin, dass die Domain über einen gültigen DMARC-Eintrag verfügt, was ein gutes Zeichen für eine legitime Domain ist.","example":true},"mxRecords":{"type":"array","description":"Liste der MX-Einträge, die mit dem Domainnamen der E-Mail verknüpft sind.","items":{"type":"string"}},"aRecords":{"type":"array","description":"Liste der A-Einträge, die mit dem Domainnamen der E-Mail verknüpft sind.","items":{"type":"string"}},"errors":{"type":"array","description":"Eine Reihe von ERRORS, die beim Versuch, diese Anfrage zu bearbeiten, aufgetreten sind.","items":{}}}},"ip-advanced":{"type":"object","properties":{"id":{"type":"string","description":"","example":"68838421827e938c9a0f53e6"},"ip":{"type":"string","description":"","example":"142.251.209.46"},"createdAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T13:18:25+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T13:18:25+00:00"},"state":{"type":"string","description":"","example":"DONE"},"requestedIp":{"type":"string"},"message":{"type":"string","description":"Meldung, die das Ergebnis des API-Aufrufs beschreibt.","example":"Success"},"success":{"type":"boolean","description":"War der API-Aufruf erfolgreich?","example":true},"proxy":{"type":"boolean","description":"Handelt es sich bei dieser IP-Adresse um einen Proxy? (SOCKS, Elite, Anonymous, VPN, TOR usw.)","example":false},"host":{"type":"string","description":"Hostname der IP-Adresse, sofern vorhanden.","example":"mil04s51-in-f14.1e100.net"},"isp":{"type":"string","description":"Internetdienstanbieter der IP-Adresse.","example":"-"},"organization":{"type":"string","description":"Aufbau der IP-Adresse.","example":"Google Workspace"},"asn":{"type":"string","description":"Nummer des autonomen Systems der IP-Adresse.","example":"-"},"countryCode":{"type":"string","description":"Zweistelliger Ländercode der IP-Adresse.","example":"IT"},"city":{"type":"string","description":"City, aus der die IP-Adresse stammt. In manchen Fällen kann dies die nächstgelegene Großstadt sein.","example":"Milan"},"region":{"type":"string","description":"Region oder Bundesland der IP-Adresse.","example":"Lombardia"},"timezone":{"type":"string","description":"Zeitzone des Standorts der IP-Adresse.","example":"Europe/Rome"},"latitude":{"type":"number","description":"Breitengrad der IP-Adresse.","example":45.47000122},"longitude":{"type":"number","description":"Längengrad der IP-Adresse.","example":9.19999981},"zipCode":{"type":"string","description":"Postleitzahl der IP-Adresse.","example":"N/A"},"isCrawler":{"type":"boolean","description":"Gehört diese IP-Adresse zu einem Crawler oder Suchmaschinen-Bot? (Google, Bing, Yandex usw.)","example":false},"connectionType":{"type":"string","description":"Klassifizierung der IP-Adresse nach Verbindungstyp. (Privathaushalt, Unternehmen, Bildungseinrichtung, Mobilfunk, Rechenzentrum)","example":"Data Center"},"recentAbuse":{"type":"boolean","description":"Wurde diese IP-Adresse kürzlich mit missbräuchlichem Verhalten in Verbindung gebracht? Zu solchen Missbräuchen zählen beispielsweise Spam im Forum, Brute-Force-Anmeldeversuche, die Verbreitung von Malware usw.","example":false},"abuseVelocity":{"type":"string","description":"Wie häufig werden Missbrauchsfälle für diese IP-Adresse aus unserem Bedrohungsnetzwerk gemeldet? (hoch, mittel, niedrig, keine)","example":"none"},"botStatus":{"type":"boolean","description":"Ist diese IP-Adresse ein bekannter Bot? Dieser Wert wird in Echtzeit aktualisiert und kann zur Bekämpfung von Bots und Klickbetrug genutzt werden.","example":false},"frequentAbuser":{"type":"boolean"},"highRiskAttacks":{"type":"boolean"},"sharedConnection":{"type":"boolean"},"dynamicConnection":{"type":"boolean"},"securityScanner":{"type":"boolean"},"trustedNetwork":{"type":"boolean"},"operatingSystem":{"type":"string"},"browser":{"type":"string"},"deviceBrand":{"type":"string"},"deviceModel":{"type":"string"},"transactionDetails":{"type":"array","items":{}},"errors":{"type":"array","items":{}},"vpn":{"type":"boolean","description":"Handelt es sich bei dieser IP-Adresse um ein VPN? Dies kann sowohl kommerzielle als auch private VPNs umfassen.","example":false},"tor":{"type":"boolean","description":"Ist diese IP-Adresse ein TOR-Ausgangsknoten?","example":false},"activeVpn":{"type":"boolean","description":"Ist diese IP-Adresse derzeit mit einer aktiven VPN-Verbindung verbunden? Diese Überprüfung erfolgt in Echtzeit und ist die genaueste Methode, um VPN-Verbindungen zu erkennen.","example":false},"activeTor":{"type":"boolean","description":"Ist diese IP-Adresse derzeit eine aktive TOR-Verbindung? Diese Überprüfung erfolgt in Echtzeit und ist die genaueste Methode, um TOR-Verbindungen zu erkennen.","example":false},"mobile":{"type":"boolean","description":"Handelt es sich bei dieser IP-Adresse um eine mobile Verbindung? (Mobilfunk) Dies ist hilfreich, um mobile Nutzer zu identifizieren.","example":false},"fraudScore":{"type":"integer","description":"Betrugsbewertung für die IP-Adresse. 0 steht für das geringste Risiko und 100 für das höchste Risiko.","example":0}}},"url-advanced":{"type":"object","properties":{"id":{"type":"string","description":"","example":"68837ffa535918d0da0a2856"},"url":{"type":"string","description":"","example":"www.openapi.com"},"createdAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T13:00:42+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T13:00:43+00:00"},"state":{"type":"string","description":"","example":"DONE"},"requestedUrl":{"type":"string","description":"","example":"www.openapi.com"},"message":{"type":"string","description":"Meldung, die das Ergebnis des API-Aufrufs beschreibt.","example":"Success."},"success":{"type":"boolean","description":"War der API-Aufruf erfolgreich?","example":true},"unsafe":{"type":"boolean","description":"Besteht der Verdacht, dass diese URL schädlich ist oder für Phishing genutzt wird? Dieser Wert ist der wichtigste Indikator für eine schädliche URL.","example":false},"domain":{"type":"string","description":"Domäne der endgültigen URL nach allen Weiterleitungen.","example":"openapi.com"},"ipAddress":{"type":"string","description":"Die IP-Adresse des Hosts der URL. Dieser Wert lautet „N/A“, wenn die IP-Adresse nicht ermittelt werden konnte.","example":"N/A"},"countryCode":{"type":"string"},"languageCode":{"type":"string"},"server":{"type":"string"},"contentType":{"type":"string"},"statusCode":{"type":"integer","example":200},"pageSize":{"type":"integer","example":1024},"domainRank":{"type":"integer"},"dnsValid":{"type":"boolean"},"parking":{"type":"boolean"},"pageTitle":{"type":"string"},"shortLinkRedirect":{"type":"boolean"},"hostedContent":{"type":"boolean"},"riskyTld":{"type":"boolean"},"spfRecord":{"type":"boolean"},"dmarcRecord":{"type":"boolean"},"mxRecords":{"type":"array","items":{"type":"string"}},"nsRecords":{"type":"array","items":{"type":"string"}},"aRecords":{"type":"array","items":{"type":"string"}},"errors":{"type":"array","items":{}},"riskScore":{"type":"integer","description":"Der Risikowert für die URL, der die Wahrscheinlichkeit abschätzt, dass es sich bei der URL um eine schädliche URL handelt. Risikowerte ab 85 gelten als hohes Risiko.","example":86},"suspicious":{"type":"boolean","description":"Wird diese URL als verdächtig oder risikobehaftet eingestuft? Dieser Wert ist eine abgeschwächte Form des Werts „unsicher“ und deutet darauf hin, dass die URL möglicherweise Teil einer böswilligen Kampagne ist.","example":true},"phishing":{"type":"boolean","description":"Steht diese URL in Zusammenhang mit einer Phishing-Kampagne? Phishing-URLs werden dazu verwendet, sensible Nutzerdaten zu stehlen.","example":false},"malware":{"type":"boolean","description":"Ist diese URL mit Malware oder Viren verbunden? Diese URLs werden dazu verwendet, Nutzer mit Schadsoftware zu infizieren.","example":false},"spamming":{"type":"boolean","description":"Steht diese URL im Zusammenhang mit Spam? Diese URLs werden in unerwünschten E-Mails und Nachrichten verwendet.","example":false},"adult":{"type":"boolean","description":"Bezieht sich diese URL auf Inhalte für Erwachsene?","example":false},"category":{"type":"string","description":"Die Kategorie des Inhalts der URL.","example":"Technology"},"technologies":{"type":"array","items":{"type":"string"},"description":"","example":["HTML5","CSS3"]},"domainAge":{"type":"object","properties":{"human":{"type":"string","example":"23 years ago"},"timestamp":{"type":"integer","example":1017170444},"iso":{"type":"string","example":"2002-03-26T14:20:44-05:00"}},"description":"Ein Objekt, das das Alter der Domain in einem für Menschen lesbaren Format sowie ein entsprechendes Datum und einen Zeitstempel im ISO-8601-Format enthält."},"redirected":{"type":"boolean","description":"Wurde der Link des Nutzers auf eine andere URL umgeleitet?","example":true},"scannedUrl":{"type":"string","description":"","example":"http://www.openapi.com"},"finalUrl":{"type":"string","description":"","example":"https://openapi.com"}}},"mobile-advanced":{"type":"object","properties":{"id":{"type":"string","description":"","example":"68837adc827e938c9a0f53e0"},"requestedNumber":{"type":"string","description":"","example":"+393334567890"},"formattedNumber":{"type":"string","description":"Die Telefonnummer im lokalen Format.","example":"+393334567890"},"createdAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T12:38:52+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T12:38:52+00:00"},"state":{"type":"string","description":"","example":"DONE"},"message":{"type":"string","description":"Meldung, die das Ergebnis des API-Aufrufs beschreibt.","example":"Phone is valid."},"success":{"type":"boolean","description":"War der API-Aufruf erfolgreich?","example":true},"valid":{"type":"boolean","description":"Ist diese Telefonnummer gültig? (wahr/falsch)","example":true},"active":{"type":"boolean","description":"Ist diese Telefonnummer aktiv und in Betrieb? Dieser Wert wird zurückgegeben, wenn der Parameter „active“ mit der Anfrage übermittelt wird.","example":true},"localFormat":{"type":"string","description":"Die Telefonnummer im lokalen Format.","example":"340 554 6935"},"fraudScore":{"type":"integer","description":"Der Betrugswert für die Telefonnummer. 0 steht für das geringste Risiko und 100 für das höchste Risiko.","example":0},"recentAbuse":{"type":"boolean","description":"Wurde diese Telefonnummer kürzlich mit Missbrauch in Verbindung gebracht? Unter Missbrauch fallen beispielsweise Spam in Foren, Brute-Force-Anmeldeversuche, gefälschte Konten usw.","example":false},"voip":{"type":"string","description":"Handelt es sich bei dieser Telefonnummer um eine Voice-over-IP-Nummer (VoIP)? (wahr/falsch) Dabei kann es sich auch um ein Objekt handeln, das zusätzliche Details enthält.","example":"-"},"prepaid":{"type":"boolean","description":"Handelt es sich bei dieser Telefonnummer um eine Prepaid-Nummer? (richtig/falsch) Dies bedeutet, dass es sich bei der Telefonnummer nicht um eine Vertragsnummer handelt.","example":false},"risky":{"type":"boolean","description":"Gilt diese Telefonnummer als risikobehaftet? (richtig/falsch) Dies deutet darauf hin, dass es sich bei der Telefonnummer wahrscheinlich um eine vorübergehende oder Wegwerfnummer handelt.","example":false},"name":{"type":"string","description":"Der Name der Person oder des Unternehmens, die bzw. das mit der Telefonnummer verknüpft ist. Dieser Wert wird nur zurückgegeben, wenn der Parameter „name“ mit der Anfrage übermittelt wird.","example":"N/A"},"identityData":{"type":"string"},"carrier":{"type":"string","description":"Der Anbieter der Telefonnummer.","example":"VODAFONE"},"lineType":{"type":"string","description":"Die Art des Telefonanschlusses. (z. B. „Mobilfunk“, „Festnetz“, „VoIP“ usw.)","example":"Wireless"},"country":{"type":"string","description":"Das Land, aus dem die Telefonnummer stammt.","example":"IT"},"region":{"type":"string"},"city":{"type":"string","description":"The city from which the phone number originates. In some cases, this may be the nearest larger city.","example":"Rome"},"accurateCountryCode":{"type":"boolean"},"zipCode":{"type":"string"},"timezone":{"type":"string","description":"Die Zeitzone des Standorts der Telefonnummer.","example":"Europe/Rome"},"dialingCode":{"type":"integer","description":"Die Vorwahl des Landes, aus dem die Telefonnummer stammt.","example":39},"doNotCall":{"type":"boolean","description":"Ist diese Telefonnummer im nationalen „Do Not Call“-Register eingetragen? (richtig/falsch)","example":false},"leaked":{"type":"boolean","description":"Ist diese Telefonnummer im Rahmen eines Datenlecks offengelegt worden? (richtig/falsch) Dies deutet darauf hin, dass die Telefonnummer im Rahmen eines Datenlecks offengelegt wurde.","example":false},"spammer":{"type":"boolean","description":"Wird diese Telefonnummer mit Spam in Verbindung gebracht? (wahr/falsch) Dies bedeutet, dass die Telefonnummer wegen Spam gemeldet wurde.","example":false},"activeStatus":{"type":"string"},"mcc":{"type":"string","description":"Mobilfunk-Ländercode, falls vorhanden.","example":"222"},"mnc":{"type":"string","description":"Mobilfunknetzcode, falls vorhanden.","example":"10"},"transactionDetails":{"type":"array","items":{}},"errors":{"type":"array","items":{}}}},"phone-advanced":{"type":"object","properties":{"id":{"type":"string","description":"","example":"68837adc827e938c9a0f53e0"},"requestedNumber":{"type":"string","description":"","example":"+390612345678"},"formattedNumber":{"type":"string","description":"Die Telefonnummer im lokalen Format.","example":"+390612345678"},"createdAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T12:38:52+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T12:38:52+00:00"},"state":{"type":"string","description":"","example":"DONE"},"message":{"type":"string","description":"Meldung, die das Ergebnis des API-Aufrufs beschreibt.","example":"Phone is valid."},"success":{"type":"boolean","description":"War der API-Aufruf erfolgreich?","example":true},"valid":{"type":"boolean","description":"Ist diese Telefonnummer gültig? (wahr/falsch)","example":true},"active":{"type":"boolean","description":"Ist diese Telefonnummer aktiv und in Betrieb? Dieser Wert wird zurückgegeben, wenn der Parameter „active“ mit der Anfrage übergeben wird.","example":true},"localFormat":{"type":"string","description":"Die Telefonnummer im lokalen Format.","example":"06 12345678"},"fraudScore":{"type":"integer","description":"Der Betrugswert für die Telefonnummer. 0 steht für das geringste Risiko und 100 für das höchste Risiko.","example":0},"recentAbuse":{"type":"boolean","description":"Wurde diese Telefonnummer kürzlich mit Missbrauch in Verbindung gebracht? Unter Missbrauch fallen beispielsweise Spam in Foren, Brute-Force-Anmeldeversuche, gefälschte Konten usw.","example":false},"voip":{"type":"string","description":"Handelt es sich bei dieser Telefonnummer um eine Voice-over-IP-Nummer (VoIP)? (wahr/falsch) Dabei kann es sich auch um ein Objekt handeln, das zusätzliche Details enthält.","example":"-"},"prepaid":{"type":"boolean","description":"Handelt es sich bei dieser Telefonnummer um eine Prepaid-Nummer? (richtig/falsch) Dies bedeutet, dass es sich bei der Telefonnummer nicht um eine Vertragsnummer handelt.","example":false},"risky":{"type":"boolean","description":"Gilt diese Telefonnummer als risikobehaftet? (richtig/falsch) Dies deutet darauf hin, dass es sich bei der Telefonnummer wahrscheinlich um eine vorübergehende oder Wegwerfnummer handelt.","example":false},"name":{"type":"string","description":"Der Name der Person oder des Unternehmens, die bzw. das mit der Telefonnummer verknüpft ist. Dieser Wert wird nur zurückgegeben, wenn der Parameter „name“ mit der Anfrage übermittelt wird.","example":"N/A"},"identityData":{"type":"string"},"carrier":{"type":"string","description":"Der Anbieter der Telefonnummer.","example":"TELECOM ITALIA"},"lineType":{"type":"string","description":"Die Art des Telefonanschlusses. (z. B. „Mobilfunk“, „Festnetz“, „VoIP“ usw.)","example":"Landline"},"country":{"type":"string","description":"Das Land, aus dem die Telefonnummer stammt.","example":"IT"},"region":{"type":"string"},"city":{"type":"string","description":"The city from which the phone number originates. In some cases, this may be the nearest larger city.","example":"Rome"},"accurateCountryCode":{"type":"boolean"},"zipCode":{"type":"string"},"timezone":{"type":"string","description":"Die Zeitzone des Standorts der Telefonnummer.","example":"Europe/Rome"},"dialingCode":{"type":"integer","description":"Die Vorwahl des Landes, aus dem die Telefonnummer stammt.","example":39},"doNotCall":{"type":"boolean","description":"Ist diese Telefonnummer im nationalen „Do Not Call“-Register eingetragen? (richtig/falsch)","example":false},"leaked":{"type":"boolean","description":"Ist diese Telefonnummer im Rahmen eines Datenlecks offengelegt worden? (richtig/falsch) Dies deutet darauf hin, dass die Telefonnummer im Rahmen eines Datenlecks offengelegt wurde.","example":false},"spammer":{"type":"boolean","description":"Wird diese Telefonnummer mit Spam in Verbindung gebracht? (wahr/falsch) Dies bedeutet, dass die Telefonnummer wegen Spam gemeldet wurde.","example":false},"activeStatus":{"type":"string"},"mcc":{"type":"string","description":"Mobilfunk-Ländercode, falls vorhanden.","example":"222"},"mnc":{"type":"string","description":"Mobilfunknetzcode, falls vorhanden.","example":"10"},"transactionDetails":{"type":"array","items":{}},"errors":{"type":"array","items":{}}}},"iban-start":{"type":"object","properties":{"id":{"type":"string","example":"69c117af962df6cee50c9525"},"iban":{"type":"string","example":"IT60X0306905020000000123456"},"state":{"type":"string","enum":["NEW","WAIT","DONE"],"example":"DONE"},"status":{"type":"string","example":"IBAN is valid"},"valid":{"type":"boolean","description":"Gilt, wenn die IBAN die Prüfungen hinsichtlich Format, Prüfsumme und Existenz der Bank bestanden hat.","example":true},"bank":{"type":"object","description":"Angaben zur Bank, zu der die IBAN gehört. Werden nur zurückgegeben, wenn die IBAN gültig ist.","nullable":true,"properties":{"abiCode":{"type":"string","nullable":true,"example":null},"address":{"type":"string","nullable":true,"example":"Piazza Vittorio Veneto 8"},"bankName":{"type":"string","nullable":true,"example":"INTESA SANPAOLO SPA"},"countryCode":{"type":"string","nullable":true,"example":"IT"},"currency":{"type":"string","nullable":true,"example":"EUR"},"swiftCode":{"type":"string","nullable":true,"example":"BLOPIT22"}}},"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}}}},"createdAt":{"type":"string","format":"date-time","example":"2026-03-30T10:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-03-30T10:00:00Z"}}},"iban-advanced":{"type":"object","properties":{"id":{"type":"string","example":"69c117af962df6cee50c9525"},"iban":{"type":"string","example":"IT60X0306905020000000123456"},"state":{"type":"string","enum":["NEW","WAIT","DONE"],"example":"DONE"},"status":{"type":"string","example":"IBAN is valid"},"bankData":{"type":"object","properties":{"bic":{"type":"string","example":"TESTITMMXXX"},"bank":{"type":"string","example":"Banca Italiana Test S.p.A."},"branch":{"type":"string","example":"Roma Sede Centrale"},"address":{"type":"string","example":"Via del Corso, 123"},"city":{"type":"string","example":"Roma"},"state":{"type":"string","nullable":true,"example":"RM"},"zipCode":{"type":"string","example":"00186"},"country":{"type":"string","example":"ITALY"},"countryCode":{"type":"string","example":"IT"},"account":{"type":"string","example":"000000123456"},"bankCode":{"type":"string","example":"03069"},"branchCode":{"type":"string","example":"05020"}}},"sepaData":{"type":"object","properties":{"creditTransfer":{"type":"boolean","example":true},"directDebit":{"type":"boolean","example":true},"cor1":{"type":"boolean","example":true},"b2b":{"type":"boolean","example":true},"cardClearing":{"type":"boolean","example":false},"creditInstantTransferRT1":{"type":"boolean","example":true},"creditInstantTransferTIPS":{"type":"boolean","example":true}}},"validations":{"type":"object","properties":{"chars":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN does not contain illegal characters"}}},"account":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"Account Number check digit is correct"}}},"iban":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN Check digit is correct"}}},"structure":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN structure is correct"}}},"length":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN Length is correct"}}},"countrySupport":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"Country supports IBAN standard"}}}}},"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}}}},"createdAt":{"type":"string","format":"date-time","example":"2026-03-30T10:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-03-30T10:00:00Z"}}},"iban-vop":{"type":"object","properties":{"id":{"type":"string","example":"69c117af962df6cee50c9525"},"iban":{"type":"string","example":"IT60X0542811101000000123456"},"name":{"type":"string","description":"Der Name des Zahlungsempfängers, dessen Überprüfung beantragt wurde.","example":"Mario Openapi"},"state":{"type":"string","enum":["NEW","WAIT","DONE"],"example":"DONE"},"vopResult":{"type":"string","description":"Das Ergebnis der Überprüfung des Zahlungsempfängers (VoP).\n- MATCH: Der Name des Zahlungsempfängers stimmt mit dem des Kontoinhabers überein\n- CLOSE_MATCH: Der Name stimmt weitgehend mit dem des Kontoinhabers überein\n- NO_MATCH: Der Name stimmt nicht mit dem des Kontoinhabers überein\n- NOT_APPLICABLE: Die VoP-Prüfung ist für diese IBAN nicht anwendbar\n- ERROR: Während des Überprüfungsprozesses ist ein Fehler aufgetreten\n- UNKNOWN: Das Ergebnis liegt nicht vor (Anfrage noch in Bearbeitung oder Überprüfung noch nicht abgeschlossen)","enum":["MATCH","CLOSE_MATCH","NO_MATCH","NOT_APPLICABLE","ERROR","UNKNOWN"],"example":"MATCH","nullable":true},"details":{"type":"object","description":"Ausführliche Informationen zum Ergebnis der Überprüfung der Übereinstimmung des Zahlungsempfängers.","nullable":true,"properties":{"matchType":{"type":"string","description":"Spezifischer Code, der die Art des Spiels angibt.","enum":["MTCH","CMTC","NMTC","NOAP"],"example":"MTCH","nullable":true},"ownerName":{"type":"string","description":"Der Name des registrierten Kontoinhabers, sofern verfügbar und vom Bankennetzwerk zurückgegeben.","example":"MARIO OPENAPI","nullable":true},"iban":{"type":"string","description":"Die verifizierte IBAN.","example":"IT60X0542811101000000123456","nullable":true}}},"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}}}},"createdAt":{"type":"string","format":"date-time","example":"2026-08-10T12:43:45+00:00"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-10T13:48:54+00:00"}}},"idv-verification":{"type":"object","properties":{"id":{"type":"string","example":"6a7c4a4d1f679b745b09b484"},"state":{"type":"string","enum":["NEW","WAIT"],"description":"„NEW“, wenn die Sitzung erstellt wird. „WAIT“, solange der Abschluss aussteht.","example":"WAIT"},"email":{"type":"string","format":"email","example":"example@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","example":"https://openapi.com"},"verificationUrl":{"type":"string","description":"URL, über die der Nutzer zur Verifizierung weitergeleitet wird. Läuft in 15 Minuten ab. Nach Ablauf wird der Status auf „abgelehnt“ gesetzt und die IDV wird mit dem Detail „applicant_never_started“ geschlossen.","example":"https://idv.checkout.com/21aef278-e68d-43bf-b12a-d63969d1dee6"},"status":{"type":"string","description":"Z. B. „created“, „pending_redirection“, „capture_in_progress“, „checks_in_progress“.","enum":["capture_in_progress","checks_in_progress","created","pending_redirection"],"example":"pending_redirection"},"details":{"type":"string","nullable":true,"description":"Liefert weitere Informationen zum Status (z. B. „applicant_never_started“)","example":null},"riskLabels":{"type":"array","items":{"type":"string"},"example":[]},"createdAt":{"type":"string","format":"date-time","example":"2026-08-12T10:26:21+00:00"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-12T10:28:20+00:00"}}},"idv-verification-done":{"type":"object","properties":{"id":{"type":"string","example":"6a7c4a4d1f679b745b09b483"},"state":{"type":"string","enum":["DONE"],"description":"„DONE“, wenn der Webhook die vom Benutzer übermittelten Daten erfolgreich verarbeitet hat.","example":"DONE"},"email":{"type":"string","format":"email","example":"example@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","example":"https://openapi.com"},"verificationUrl":{"type":"string","description":"URL, über die der Nutzer zur Verifizierung weitergeleitet wird. Läuft in 15 Minuten ab. Nach Ablauf wird der Status auf „abgelehnt“ gesetzt und die IDV wird mit dem Detail „applicant_never_started“ geschlossen.","example":"https://idv.checkout.com/21aef278-e68d-43bf-b12a-d63969d1dee6"},"status":{"type":"string","description":"Z. B. genehmigt, abgelehnt, unklar, verweigert.","enum":["approved","declined","inconclusive","refused"],"example":"approved"},"details":{"type":"string","nullable":true,"description":"Liefert weitere Informationen zum Status (z. B. „genehmigt“, „document_counterfeit“, „capture_aborted“, „applicant_never_started“)","example":"approved"},"riskLabels":{"type":"array","items":{"type":"string"},"example":[]},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"ID"},"number":{"type":"string","example":"CA12345AA"},"issuingCountry":{"type":"string","example":"IT"},"issueDate":{"type":"string","format":"date","example":"2020-02-12"},"expiryDate":{"type":"string","format":"date","example":"2031-02-06"},"mrz":{"type":"string","example":"C<ITACA12345AA1<<<<<<<<<<<<<<<0002060M3102064ITA<<<<<<<<<<<4OPENAPI<<MARIO<<<<<<<<<<<<<"},"birthDate":{"type":"string","format":"date","example":"2000-02-06"},"firstName":{"type":"string","example":"MARIO"},"lastName":{"type":"string","example":"OPENAPI"},"fullName":{"type":"string","example":"MARIO OPENAPI"}}}},"age":{"type":"integer","example":26},"attempts":{"type":"integer","example":2},"attemptInfo":{"type":"object","properties":{"createdOn":{"type":"string","format":"date-time","example":"2026-08-12T10:28:20.197525Z"},"modifiedOn":{"type":"string","format":"date-time","example":"2026-08-12T10:35:08.082863Z"},"status":{"type":"string","example":"completed"},"clientInformation":{"type":"string","nullable":true},"applicantSessionInformation":{"type":"object","nullable":true,"properties":{"ip_address":{"type":"string","example":"203.0.113.45"},"number_of_sessions":{"type":"integer","example":2},"user_agent":{"type":"string","example":"Mozilla/5.0 (Linux; Android 10; 2312DRA50G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/151.0.0.0 Mobile Safari/537.36"},"initial_device":{"type":"string","example":"desktop"},"selected_documents":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string","example":"IT"},"document_type":{"type":"string","example":"ID"}}}}}},"responseCodes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"integer","example":10000},"summary":{"type":"string","example":"approved"}}}},"verificationUrl":{"type":"string","example":"https://idv.checkout.com/21aef278-e68d-43bf-b12a-d63969d1dee6"}}},"createdAt":{"type":"string","format":"date-time","example":"2026-08-12T10:26:21+00:00"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-12T10:35:15+00:00"}}},"idv-audit-trail":{"type":"object","properties":{"id":{"type":"string","example":"6a79c781338ec58b7b0182b4"},"state":{"type":"string","enum":["NEW","DONE"],"example":"DONE"},"email":{"type":"string","format":"email","example":"mario@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","format":"uri","example":"https://openapi.com"},"verificationUrl":{"type":"string","example":"https://idv.checkout.com/e745d3f2-ad4d-4a9c-acd1-e830f7da8e6a"},"status":{"type":"string","example":"approved"},"details":{"type":"string","example":"approved"},"riskLabels":{"type":"array","items":{"type":"string"}},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"ID"},"number":{"type":"string","example":"CA12345AA"},"issuingCountry":{"type":"string","example":"IT"},"issueDate":{"type":"string","format":"date","example":"2020-02-12"},"expiryDate":{"type":"string","format":"date","example":"2031-02-06"},"mrz":{"type":"string","example":"C<ITACA12345AA1<<<<<<<<<<<<<<<"},"birthDate":{"type":"string","format":"date","example":"2000-02-06"},"firstName":{"type":"string","example":"MARIO"},"lastName":{"type":"string","example":"OPENAPI"},"fullName":{"type":"string","example":"MARIO OPENAPI"}}}},"age":{"type":"integer","example":26},"attempts":{"type":"integer","example":3},"attemptInfo":{"type":"object","properties":{"createdOn":{"type":"string","format":"date-time","example":"2026-08-10T13:39:54.480325Z"},"modifiedOn":{"type":"string","format":"date-time","example":"2026-08-10T13:48:52.398519Z"},"status":{"type":"string","example":"completed"},"clientInformation":{"type":"string","nullable":true},"applicantSessionInformation":{"type":"object","nullable":true,"properties":{"ip_address":{"type":"string","example":"81.127.114.165"},"number_of_sessions":{"type":"integer","example":2},"user_agent":{"type":"string","example":"Mozilla/5.0 (Linux; Android 10; 2312DRA50G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/151.0.0.0 Mobile Safari/537.36"},"initial_device":{"type":"string","example":"desktop"},"selected_documents":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string","example":"IT"},"document_type":{"type":"string","example":"ID"}}}}}},"responseCodes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"integer","example":10000},"summary":{"type":"string","example":"approved"}}}},"verificationUrl":{"type":"string","example":"https://idv.checkout.com/e745d3f2-ad4d-4a9c-acd1-e830f7da8e6a"}}},"createdAt":{"type":"string","format":"date-time","example":"2026-08-10T12:43:45+00:00"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-10T13:48:54+00:00"}}}}},"paths":{"/mobile-start":{"get":{"tags":["HLR"],"summary":"Alle HLR-Anfragen auflisten","description":"Gibt eine paginierte Liste Ihrer „mobile-start“-Validierungsanfragen zurück.","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/mobile-start"}}}}}}}}}},"/mobile-start/{id}":{"get":{"tags":["HLR"],"summary":"Eine bestimmte HLR-Anfrage abrufen","description":"Gibt eine Anfragedetailansicht zurück, um den „Status“ zu überprüfen.","parameters":[{"name":"id","in":"path","description":"Mit der POST-Methode abgerufene Anfrage-ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/mobile-start"}}}]}}}},"404":{"description":"Nicht gefunden"},"406":{"description":"Nicht zulässig – Ungültige ID"}}}},"/mobile-start/{mobile-phone-number}":{"post":{"tags":["HLR"],"summary":"Eine neue HLR-Anfrage erstellen","description":"Erstellt eine neue Anfrage. Das System startet eine globale HLR-Abfrage für die angegebene Telefonnummer. Wenn die Anfrage in die Warteschlange gestellt wird, lautet der Status `NEW` oder `WAIT`. Netzwerkfehler werden intern durch automatische Wiederholungsversuche behandelt. Geben Sie ein `callback`-Objekt an, um benachrichtigt zu werden, wenn der Status auf `DONE` wechselt, oder fragen Sie den GET-Endpunkt mithilfe der zurückgegebenen ID ab.","parameters":[{"name":"mobile-phone-number","in":"path","description":"Die Handynummer einschließlich der internationalen Vorwahl","required":true,"schema":{"type":"string","example":"+393939989747"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/mobile-start"}}}]}}}},"406":{"description":"Nicht zulässig – Ungültige Telefonnummer"}}}},"/email-start":{"get":{"tags":["Email"],"summary":"Alle E-Mail-Anfragen auflisten","description":"Gibt eine paginierte Liste Ihrer Validierungsanfragen für E-Mail-Adressen mit -start- zurück.","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/email-start"}}}}}}}}}},"/email-start/{id}":{"get":{"tags":["Email"],"summary":"Eine E-Mail-Bestätigungsanfrage abrufen","description":"Gibt die Details einer E-Mail-Validierungsanfrage zurück, um deren Status und Ergebnisse zu überprüfen.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/email-start"}}}]}}}},"404":{"description":"Nicht gefunden"}}}},"/email-start/{email}":{"post":{"tags":["Email"],"summary":"Eine neue Anfrage zur E-Mail-Validierung erstellen","description":"Erstellt eine Anfrage zur Überprüfung einer E-Mail-Adresse. Sie erhalten umgehend eine ID mit dem Status `NEW` oder `WAIT`. Sobald die Anfrage von der Warteschlange verarbeitet wurde, wechselt der Status zu `DONE`. Überprüfen Sie den Status manuell mit einem GET-Aufruf oder warten Sie auf den Webhook-Callback.","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","format":"email"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/email-start"}}}]}}}},"406":{"description":"Nicht zulässig – Ungültiges E-Mail-Format"}}}},"/email-advanced":{"get":{"tags":["Email"],"summary":"Alle advanced E-Mail-Anfragen auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/email-advanced"}}}}}}}}}},"/email-advanced/{id}":{"get":{"tags":["Email"],"summary":"Eine advanced E-Mail-Validierungsanfrage abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/email-advanced"}}}]}}}},"404":{"description":"Nicht gefunden"}}}},"/email-advanced/{email}":{"post":{"tags":["Email"],"summary":"Eine neue advanced E-Mail-Validierungsanfrage erstellen","description":"Erstellt eine neue Anfrage für eine advanced E-Mail-Validierung, einschließlich Betrugsbewertung, Zustellbarkeit und Reputation. Der Status wird nach Abschluss auf `DONE` aktualisiert.","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","format":"email"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/email-advanced"}}}]}}}},"406":{"description":"Nicht zulässig – Ungültiges E-Mail-Format"}}}},"/ip-advanced":{"get":{"tags":["IP & Proxy"],"summary":"Alle „advanced IP“-Anfragen auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ip-advanced"}}}}}}}}}},"/ip-advanced/{id}":{"get":{"tags":["IP & Proxy"],"summary":"Eine Anfrage zur advanced IP-Analyse abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ip-advanced"}}}]}}}}}}},"/ip-advanced/{ip}":{"post":{"tags":["IP & Proxy"],"summary":"Eine neue Anfrage zur advanced IP-Analyse erstellen","description":"Eine IP-Adresse auf Proxy-, VPN- und TOR-Verbindungen analysieren und ihren Betrugswert bewerten.","parameters":[{"name":"ip","in":"path","required":true,"schema":{"type":"string","example":"1.1.1.1"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ip-advanced"}}}]}}}}}}},"/url-advanced":{"get":{"tags":["URL"],"summary":"Alle URL-Anfragen auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/url-advanced"}}}}}}}}}},"/url-advanced/{id}":{"get":{"tags":["URL"],"summary":"Eine advanced URL-Scan-Anfrage abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/url-advanced"}}}]}}}}}}},"/url-advanced/{url}":{"post":{"tags":["URL"],"summary":"Eine neue Anfrage für einen advanced URL-Scan erstellen","description":"Überprüfen Sie eine URL auf Phishing, Malware und andere Bedrohungen.","parameters":[{"name":"url","in":"path","required":true,"schema":{"type":"string","example":"https://example.com"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/url-advanced"}}}]}}}}}}},"/mobile-advanced":{"get":{"tags":["HLR"],"summary":"Alle „advanced“-Anfragen auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/mobile-advanced"}}}}}}}}}},"/mobile-advanced/{id}":{"get":{"tags":["HLR"],"summary":"Eine advanced Anfrage zur Handynummernüberprüfung abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/mobile-advanced"}}}]}}}},"404":{"description":"Anfrage nicht gefunden"}}}},"/mobile-advanced/{mobile-phone-number}":{"post":{"tags":["HLR"],"summary":"Eine neue advanced Anfrage zur Validierung eines Mobiltelefons erstellen","description":"Überprüfen Sie eine MOBILFUNK-Nummer hinsichtlich Betrugsrisiko, Netzbetreiber, Anschlussart usw.","parameters":[{"name":"mobile-phone-number","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/mobile-advanced"}}}]}}}}}}},"/phone-advanced":{"get":{"tags":["HLR"],"summary":"Alle „advanced“-Anfragen auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/phone-advanced"}}}}}}}}}},"/phone-advanced/{id}":{"get":{"tags":["HLR"],"summary":"Eine advanced Anfrage zur Telefonüberprüfung abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/phone-advanced"}}}]}}}},"404":{"description":"Anfrage nicht gefunden"}}}},"/phone-advanced/{phone-number}":{"post":{"tags":["HLR"],"summary":"Eine neue advanced Anfrage zur Telefonüberprüfung erstellen","description":"Überprüfen Sie BELIEBIGE Telefonnummern (Mobil- oder Festnetznummern) im E164-Format. **Hinweis:** Telefonnummern mit insgesamt weniger als 10 Ziffern (einschließlich Ländervorwahl) werden vom Upstream-Netzwerk nicht unterstützt und mit dem Statuscode 406 REJECTED abgelehnt.","parameters":[{"name":"phone-number","in":"path","required":true,"description":"Die Telefonnummer einschließlich der Ländervorwahl (mindestens 10 Ziffern).","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/phone-advanced"}}}]}}}}}}},"/iban-start":{"get":{"tags":["IBAN Verification"],"summary":"Alle IBAN-Anfragen auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/iban-start"}}}}}}}}}},"/iban-start/{id}":{"get":{"tags":["IBAN Verification"],"summary":"Eine IBAN-Validierungsanfrage abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/iban-start"}}}]}}}}}}},"/iban-start/{iban}":{"post":{"tags":["IBAN Verification"],"summary":"Eine neue IBAN-Prüfungsanfrage erstellen","description":"Eine IBAN validieren (Format, Prüfsumme und Existenz der Bank) und die grundlegenden Angaben zur zugehörigen Bank zurückgeben.","parameters":[{"name":"iban","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/iban-start"}}}]}}}}}}},"/iban-advanced":{"get":{"tags":["IBAN Verification"],"summary":"Alle Anfragen zu advanced IBANs auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/iban-advanced"}}}}}}}}}},"/iban-advanced/{id}":{"get":{"tags":["IBAN Verification"],"summary":"Eine Anfrage zur advanced IBAN-Validierung abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/iban-advanced"}}}]}}}}}}},"/iban-advanced/{iban}":{"post":{"tags":["IBAN Verification"],"summary":"Eine neue Anfrage zur advanced IBAN-Validierung erstellen","description":"Eine IBAN validieren, detaillierte Daten zur Bankfiliale abrufen und die SEPA-Erreichbarkeit prüfen.","parameters":[{"name":"iban","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/iban-advanced"}}}]}}}}}}},"/iban-vop":{"get":{"tags":["IBAN Verification"],"summary":"Alle Anträge auf IBAN-Überprüfung des Zahlungsempfängers (VoP) auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/iban-vop"}}}}}}}}},"post":{"tags":["IBAN Verification"],"summary":"Neue Anfrage zur advanced IBAN-Validierung erstellen (Überprüfung des Zahlungsempfängers)","description":"Überprüfen Sie eine IBAN und verifizieren Sie die Identität des Zahlungsempfängers mithilfe des „Verification of Payee“ (VoP)-Gateways. Dazu müssen im JSON-Anfragetext sowohl der Parameter „iban“ als auch der Parameter „name“ enthalten sein.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["iban","name"],"properties":{"iban":{"type":"string","description":"Die IBAN-Adresse des zu überprüfenden Begünstigten/Zahlungsempfängers.","example":"IT60X0542811101000000123456"},"name":{"type":"string","description":"Der Name des Begünstigten/Zahlungsempfängers, der mit dem Bankkonto abgeglichen werden soll.","example":"Mario Openapi"},"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/iban-vop"}}}]}}}}}}},"/iban-vop/{id}":{"get":{"tags":["IBAN Verification"],"summary":"Eine IBAN-Überprüfung des Zahlungsempfängers (VoP) abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/iban-vop"}}}]}}}}}}},"/idv-flash-start":{"get":{"tags":["Identity Verification"],"summary":"Alle Flash-Identitätsprüfungen auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/idv-verification-done"},{"$ref":"#/components/schemas/idv-verification"}]}}}}}}}}},"post":{"tags":["Identity Verification"],"summary":"Eine neue Anfrage zur Identitätsprüfung erstellen","description":"Erstellt eine synchrone Verifizierungsanfrage beim Anbieter (KI-gestützt). Sie erhalten umgehend eine `verificationUrl`, über die Sie den Nutzer zur Einleitung der Sitzung weiterleiten können. Der Status lautet zunächst `NEW` und wird über Webhooks auf `DONE` aktualisiert, sobald der Nutzer den Vorgang abgeschlossen hat. Wir empfehlen dringend, den Callback-Parameter zur Nutzlast hinzuzufügen, damit Sie bei jeder Aktualisierung Benachrichtigungen erhalten.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","name","redirectUrl"],"properties":{"email":{"type":"string","format":"email","example":"example@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","format":"uri","example":"https://openapi.com"},"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/idv-verification"}}}]}}}}}}},"/idv-flash-start/{id}":{"get":{"tags":["Identity Verification"],"summary":"Eine Anfrage zur Identitätsprüfung abrufen","description":"Gibt die Details einer Identitätsüberprüfungsanfrage zurück. Verwenden Sie „Accept: application/pdf“, um einen vollständigen PDF-Bericht zu erhalten, oder „Accept: text/html“ für HTML.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/idv-verification-done"},{"$ref":"#/components/schemas/idv-verification"}]}}}]}},"application/pdf":{"schema":{"type":"string","format":"binary","description":"Vollständiger Prüfbericht im PDF-Format."}},"text/html":{"schema":{"type":"string","description":"Vollständiger Prüfbericht im HTML-Format."}}}}}}},"/idv-flash-start/{id}/front":{"get":{"tags":["Identity Verification"],"summary":"Vorderseite des Dokuments abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-flash-start/{id}/back":{"get":{"tags":["Identity Verification"],"summary":"Dokument-Rückseitenbild abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-flash-advanced":{"get":{"tags":["Identity Verification"],"summary":"Alle advanced Identitätsprüfungen mit Flash auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/idv-verification-done"},{"$ref":"#/components/schemas/idv-verification"}]}}}}}}}}},"post":{"tags":["Identity Verification"],"summary":"Eine neue Anfrage zur advanced Identitätsprüfung erstellen","description":"Erstellt eine synchrone Verifizierungsanfrage beim Anbieter (KI-gestützt + Gesichtserfassung). Sie erhalten umgehend eine „verificationUrl“, über die Sie den Nutzer zum Start der Sitzung weiterleiten können. Der Status lautet zunächst „NEW“ und wird über Webhooks auf „DONE“ aktualisiert, sobald der Nutzer den Vorgang abgeschlossen hat. Wir empfehlen dringend, den Parameter „callback“ zur Nutzlast hinzuzufügen, damit Sie bei jeder Aktualisierung Benachrichtigungen erhalten.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","name","redirectUrl"],"properties":{"email":{"type":"string","format":"email","example":"example@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","format":"uri","example":"https://openapi.com"},"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/idv-verification"}}}]}}}}}}},"/idv-flash-advanced/{id}":{"get":{"tags":["Identity Verification"],"summary":"Eine Anfrage zur advanced Identitätsprüfung abrufen","description":"Gibt die Details zurück. Verwenden Sie „Accept: application/pdf“, um einen vollständigen PDF-Bericht zu erhalten.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/idv-verification-done"},{"$ref":"#/components/schemas/idv-verification"}]}}}]}},"application/pdf":{"schema":{"type":"string","format":"binary","description":"Vollständiger Prüfbericht im PDF-Format."}}}}}}},"/idv-flash-advanced/{id}/front":{"get":{"tags":["Identity Verification"],"summary":"Vorderseite des Dokuments abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-flash-advanced/{id}/back":{"get":{"tags":["Identity Verification"],"summary":"Dokument-Rückseitenbild abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-flash-advanced/{id}/face":{"get":{"tags":["Identity Verification"],"summary":"Gesichtsbild abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-expert":{"get":{"tags":["Identity Verification"],"summary":"Alle Identitätsprüfungen durch Experten auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/idv-verification-done"},{"$ref":"#/components/schemas/idv-verification"}]}}}}}}}}},"post":{"tags":["Identity Verification"],"summary":"Eine neue Anfrage zur Identitätsprüfung durch einen Experten erstellen","description":"Erstellt eine synchrone Verifizierungsanfrage beim Anbieter (unter Kombination von KI und menschlicher Expertenprüfung). Sie erhalten umgehend eine `verificationUrl`, über die Sie den Nutzer zum Start der Sitzung weiterleiten können. Der Status lautet zunächst `NEW` und wird über Webhooks auf `DONE` aktualisiert, sobald der Nutzer den Vorgang abgeschlossen hat. Wir empfehlen dringend, den Callback-Parameter zur Nutzlast hinzuzufügen, damit Sie bei jeder Aktualisierung Benachrichtigungen erhalten.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","name","redirectUrl"],"properties":{"email":{"type":"string","format":"email","example":"example@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","format":"uri","example":"https://openapi.com"},"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/idv-verification"}}}]}}}}}}},"/idv-expert/{id}":{"get":{"tags":["Identity Verification"],"summary":"Eine Anfrage zur Identitätsprüfung durch einen Experten abrufen","description":"Gibt die Details einer Identitätsüberprüfungsanfrage zurück. Verwenden Sie „Accept: application/pdf“, um einen vollständigen PDF-Bericht zu erhalten.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/idv-verification-done"},{"$ref":"#/components/schemas/idv-verification"}]}}}]}},"application/pdf":{"schema":{"type":"string","format":"binary","description":"Vollständiger Prüfbericht im PDF-Format."}}}}}}},"/idv-expert/{id}/front":{"get":{"tags":["Identity Verification"],"summary":"Vorderseite des Dokuments abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-expert/{id}/back":{"get":{"tags":["Identity Verification"],"summary":"Dokument-Rückseitenbild abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-expert/{id}/face":{"get":{"tags":["Identity Verification"],"summary":"Gesichtsbild abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-certified":{"get":{"tags":["Identity Verification"],"summary":"Alle zertifizierten Identitätsüberprüfungen auflisten","parameters":[{"$ref":"#/components/parameters/skipParam"},{"$ref":"#/components/parameters/limitParam"},{"$ref":"#/components/parameters/stateQueryParam"}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/idv-verification-done"},{"$ref":"#/components/schemas/idv-verification"}]}}}}}}}}},"post":{"tags":["Identity Verification"],"summary":"Eine neue Anfrage zur zertifizierten Identitätsprüfung erstellen","description":"Erstellt eine synchrone Verifizierungsanfrage beim Anbieter (ANSSI-zertifiziert). Sie erhalten umgehend eine `verificationUrl`, über die Sie den Nutzer zur Einleitung der Sitzung weiterleiten können. Der Status lautet zunächst `NEW` und wird über Webhooks auf `DONE` aktualisiert, sobald der Nutzer den Vorgang abgeschlossen hat. Wir empfehlen dringend, den Callback-Parameter zur Nutzlast hinzuzufügen, damit Sie bei jeder Aktualisierung Benachrichtigungen erhalten.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","name","redirectUrl"],"properties":{"email":{"type":"string","format":"email","example":"example@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","format":"uri","example":"https://openapi.com"},"callback":{"$ref":"#/components/schemas/Callback"}}}}}},"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/idv-verification"}}}]}}}}}}},"/idv-certified/{id}":{"get":{"tags":["Identity Verification"],"summary":"Eine Anfrage zur zertifizierten Identitätsprüfung abrufen","description":"Gibt die Details einer Identitätsüberprüfungsanfrage zurück. Verwenden Sie „Accept: application/pdf“, um einen vollständigen PDF-Bericht zu erhalten.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/idv-verification-done"},{"$ref":"#/components/schemas/idv-verification"}]}}}]}},"application/pdf":{"schema":{"type":"string","format":"binary","description":"Vollständiger Prüfbericht im PDF-Format."}}}}}}},"/idv-certified/{id}/front":{"get":{"tags":["Identity Verification"],"summary":"Vorderseite des Dokuments abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-certified/{id}/back":{"get":{"tags":["Identity Verification"],"summary":"Dokument-Rückseitenbild abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-certified/{id}/face":{"get":{"tags":["Identity Verification"],"summary":"Gesichtsbild abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}}}}},"/idv-retry/{id}":{"get":{"tags":["Identity Verification"],"summary":"Einen neuen Versuch für eine abgelehnte oder nicht eindeutige Identitätsprüfung beantragen","description":"Aktualisiert die Verifizierungssitzung und gibt eine neue „verificationUrl“ zurück. Dies ist nur bei bestimmten Fehlerstatus und im Rahmen der zulässigen Anzahl von Versuchen zulässig.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/idv-verification"}}}]}}}},"400":{"description":"Bad Request – Wiederholung nicht zulässig","content":{"application/json":{"example":{"success":false,"message":"Retry not allowed for this verification","error":450,"data":null}}}}}}},"/idv-audit-trail/{id}":{"get":{"tags":["Identity Verification"],"summary":"Den Prüfpfad einer Identitätsüberprüfungsanfrage abrufen","description":"Gibt alle Details zu den Versuchen, Sitzungen und Ergebnissen zurück, die mit der Verifizierung in Zusammenhang stehen.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Antwort 200 OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/GenericResponseWrapper"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/idv-audit-trail"}}}]}}}}}}}},"externalDocs":{"description":"Zum ersten Mal hier? Erstellen Sie einen neuen Zugriffstoken.","url":"https://console.openapi.com/de/oauth"},"security":[{"bearerAuth":[]}]}