--- title: Prozess abrufen description: Rufen Sie einen bestehenden Prozess aus dem API-Contract anhand seiner Kennung ab. Wird für erneute Abfragen verwendet, da die Ergebnisse bei der Erstellung synchron zurückgegeben werden. canonical: https://developer.unico.io/de/dual-api/developers/api-reference/api/get-process locale: de generated_by: markdown-export --- - [/de/](/de/) - [API-Referenz](/de/dual-api/developers/api-reference/) - [API](/de/dual-api/developers/api-reference/api/) - Prozess abrufen **Auf dieser SeiteProzess abrufenGETRufen Sie einen bestehenden Prozess anhand seiner Kennung ab. Gemäß dem API-Contract wird das Ergebnis bereits synchron bei der Prozesserstellung zurückgegeben — verwenden Sie diesen Endpunkt für erneute Abfragen, Audits und Support. WarnungBevor Sie den Prozess abrufen, prüfen Sie unsere Webhook-Konfiguration und Fallback-Strategien — [hier klicken](/de/developers/webhooks-and-events/setup). ### Endpunkt​ UmgebungURL**Produktion**`GET https://api.id.unico.app/processes/v1/{processId}`**Sandbox**`GET https://api.id.uat.unico.app/processes/v1/{processId}` ### Anfrage​ Headers HeaderWert`Authorization``Bearer ``APIKEY`Bereitgestellter API-Schlüssel. Pfadparameter ParameterTypErforderlichBeschreibung`processId`string (UUID)jaProzesskennung, die von [Prozess erstellen](/de/dual-api/developers/api-reference/api/post-processes) zurückgegeben wird. ### Beispiel​ cURLNode.js``` curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \ -H "Authorization: Bearer $TOKEN" \ -H "APIKEY: $API_KEY" ``` ``` import fetch from 'node-fetch';const res = await fetch( `https://api.id.unico.app/processes/v1/${processId}`, { headers: { Authorization: `Bearer ${accessToken}`, APIKEY: apiKey } });const result = await res.json(); ``` ### Antworten​ 200 OK Der Contract ist einheitlich — das Feld `idCloud.result` trägt das konsolidierte Urteil der verwendeten Fähigkeiten. Unico konsolidiert die Ergebnisse der ausgeführten Fähigkeiten in einem einzigen `idCloud.result`, bereit, um den nächsten Schritt Ihres Flows zu entscheiden — ohne dass Sie einzelne Ergebnisse orchestrieren müssen. ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "idCloud": { "result": "approved" }} ``` FeldTypBeschreibung`id`string (UUID)Prozesskennung.`status`integer`1` (in Bearbeitung), `2` (Abweichung), `3` (erfolgreich abgeschlossen), `4` (storniert), `5` (Fehler). Mögliche Ergebniswerte idCloud.resultBedeutungEmpfohlene AktionapprovedEchte Person und validierte Identität.Mit dem Flow fortfahren.deniedIdentität nicht validiert, Lebenderkennung fehlgeschlagen oder extremes Risiko erkannt.Flow beenden oder zu einem alternativen Flow weiterleiten.critical-riskKritisches Risikoniveau erkannt.Flow beenden oder an die manuelle Prüfung weiterleiten.high-riskHohes Risikoniveau erkannt.An die manuelle Prüfung oder einen alternativen Flow weiterleiten.retryUnzureichende Erfassung oder Score zur Auswertung.Den Benutzer um eine neue Erfassung bitten.inconclusiveNicht genügend Nachweise für ein Urteil.An die manuelle Prüfung oder einen alternativen Flow weiterleiten. Die zurückgegebenen Werte hängen vom Recipe ab, das in Ihrem APIKey konfiguriert ist. Siehe [Flows](/de/dual-api/developers/api-reference/api/flows) für die Ergebniswerte, die jedes Recipe zurückgeben kann. Kunden in Brasilien erhalten möglicherweise die Antwort nach FähigkeitDie Gesamtstruktur der Antwort bleibt gleich — das einzelne Ergebnis ist der Standard.Integrationen in Brasilien erhalten möglicherweise die offenen Ergebnisse pro Fähigkeit. Jede in der APIKey aktivierte Fähigkeit fügt der Antwort einen eigenen Block hinzu — Felder für deaktivierte Fähigkeiten werden weggelassen.``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "unicoId": { "result": "yes" }, "riskLevel": { "result": "inconclusive" }, "idFace": { "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890", "result": "FOUND" }, "identityFraudsters": { "result": "inconclusive" }, "government": { "serpro": 87 }, "liveness": 1, "idAge": { "result": "yes" }, "cardholderVerification": { "result": "approved" }} ``` FeldTypBeschreibung`unicoId.result`string`yes`, `no`, `inconclusive` — siehe [Identitätsprüfung](/de/capabilities/identity-verification).`riskLevel.result`string`not_approved`, `critical_risk`, `high_risk`, `inconclusive` — siehe [Betrugseinstufung nach Risiko](/de/capabilities/fraud-risk-classification).`idFace.result`string`FOUND` — siehe Gesichts-Identifikator.`idFace.personId`stringStabiler, opaker Bezeichner für das Gesicht, zurückgegeben zusammen mit `idFace.result = FOUND`. Kann kein Gesicht im Bild identifiziert werden, liefert der Prozess Fehler `20532` anstelle eines `idFace`-Blocks.`identityFraudsters.result`string**Veraltet.** Verwenden Sie stattdessen `riskLevel`. Kunden mit laufenden Integrationen können es weiterhin verwenden, während sie die Migration mit ihrem Projektteam koordinieren.`government.serpro`integerSerpro-Ähnlichkeitswert (0–100, -1, -2). Nur in Brasilien verfügbar. Siehe [Serpro-Ähnlichkeitsabgleich](/de/capabilities/serpro-similarity-return).`liveness`integer`1` (bestanden), `2` (nicht bestanden) — siehe [Lebenderkennung](/de/capabilities/liveness).`idAge.result`string`yes`, `no`, `inconclusive` — siehe [Altersverifizierung](/de/capabilities/age-verification). Nur in Brasilien verfügbar.`score`integerProbabilistischer Risiko-Score. Vorhanden, wenn `unicoId.result = inconclusive` und die Risiko-Score-Orchestrierung aktiv ist. Positive Werte deuten auf eine höhere Wahrscheinlichkeit hin, dass es sich um den Inhaber handelt; negative Werte deuten auf ein höheres Risiko hin. Nur in Brasilien verfügbar.`cardholderVerification.result`string`approved`, `unsure` — siehe [Cardholder Verification](/de/capabilities/cardholder-verification). Fehlt, solange `status` noch nicht `3` (abgeschlossen) ist. Nur in Brasilien verfügbar. Kunden in Mexiko erhalten möglicherweise den Block der RENAPO-VerifizierungDie Antwort behält dieselbe Struktur und ergänzt den idGov-Block.Integrationen in Mexiko mit aktivierter RENAPO-Verifizierung erhalten einen zusätzlichen idGov-Block mit dem Eintrag, den RENAPO zur CURP des Benutzers führt. Er ist eine separate Antwort neben dem Identitätsergebnis.``` { "id": "11111111-2222-3333-4444-555555555555", "status": 3, "idCloud": { "result": "approved" }, "idGov": { "government_valid": true, "curp": "PUEA880304MDFRJN04", "government_name": "ANA PRUEBA EJEMPLO", "date_of_birth": "1988-03-04", "age": 38, "gender": "F", "deceased": false, "is_mexican": true, "citizenship": "MEXICO", "state_of_birth": "Ciudad de México", "state_iso": "MX-CMX", "issuing_entity_code": "DF", "municipality_registration": "" }} ``` FeldTypBeschreibung`idGov`objectRENAPO-Eintrag zur CURP. Fehlt, wenn die Capability nicht aktiviert ist. `{}`, wenn RENAPO nicht geantwortet hat. Nur Mexiko. Siehe [RENAPO-Verifizierung](/de/capabilities/renapo-verification). ### Wann dieser Endpunkt verwendet werden sollte​ Der API-Contract gibt Ergebnisse synchron zurück, daher benötigen die meisten Integrationen diesen Endpunkt nicht. Verwenden Sie ihn, wenn: Sie nur die `processId` gespeichert haben und das vollständige Ergebnis später abrufen müssen (Audit, Support). Sie vermuten, dass die ursprüngliche Antwort während der Übertragung verloren ging (Netzwerkfehler, nachdem die Plattform die Arbeit abgeschlossen hat). Sie ein Back-Office-Tool erstellen, das historische Prozesse überprüft. ### Fehlercodes​ 400 Bad Request404 Not Found403 Forbidden410 Gone429 Too Many Requests500 Internal Server ErrorCodeNachrichtBeschreibung`20023`O parâmetro processId não foi informado.Der processId-Parameter fehlt.`20002`O parâmetro APIKey não foi informado.Der APIKEY-Parameter fehlt im Anfrage-Header.`20001`O parâmetro authtoken não foi informado.Der Integrationstoken-Parameter fehlt im Anfrage-Header.CodeNachrichtBeschreibung`50001`O processo informado não foi encontrado.Der Prozess existiert nicht in der Datenbank.CodeNachrichtBeschreibung`30017`User does not have permission to perform this action.Fehlerhaftes JWT oder Benutzer ohne Berechtigung für diese Operation.`10502`O token informado está expirado.Wenn das verwendete Access-Token abgelaufen ist.`10501`O token informado é inválido.Das Authentifizierungstoken ist ungültig.`10201`O AppKey informado é inválido.Der APIKEY-Parameter wurde nicht angegeben oder existiert nicht.Der Prozess existiert, resultierte jedoch in einem Fehler. Gibt nur `id` und `status: 5` zurück.Rate-Limit erreicht. Wenn Ihr System einen HTTP-429-Fehler erhält, müssen Sie Mechanismen implementieren, um kaskadierende Ausfälle zu verhindern und eine Verschärfung der Einschränkung zu vermeiden. **Best Practices:** **Abkühlphase (Backoff):** Stoppen oder drosseln Sie nachfolgende Anfragen aus Ihrem System sofort. Wiederholen Sie fehlgeschlagene Anfragen nicht kontinuierlich in einer engen Schleife. **Warteschlange & Drosselung:** Puffern oder reihen Sie ausgehende Anfragen auf Ihrer Seite ein, um den Datenverkehr zu kontrollieren, bevor Sie sie erneut senden. **Exponentieller Backoff mit Jitter:** Erhöhen Sie beim erneuten Versuch die Wartezeit zwischen den Versuchen exponentiell (z. B. 1 s, 2 s, 4 s, 8 s) und fügen Sie eine kleine zufällige Verzögerung ("Jitter") hinzu, um einen Herdeneffekt zu vermeiden, bei dem alle in der Warteschlange befindlichen Anfragen exakt zur gleichen Millisekunde erneut versucht werden. WarnungDas kontinuierliche Ansprechen eines rate-limitierten Endpunkts ohne Backoff kann **die Einschränkungsperiode verlängern** und den operativen Durchsatz Ihres Systems erheblich beeinträchtigen. Eine ordnungsgemäße Drosselung der Anfragen auf Ihrer Seite gewährleistet eine reibungslosere und widerstandsfähigere Integration. Informationen zu Standardlimits, Erhöhung von Anfragen und weiteren Details finden Sie unter [Rate Limits](/de/dual-api/developers/api-reference/rate-limits).CodeNachrichtBeschreibung`99999`Internal failure! Try again laterWenn ein interner Fehler auftritt. ### Flows​ Ein Recipe ist die Kombination von Fähigkeiten (Lebenderkennung, Identitätsprüfung, Risikosignale, Dokumente ...), die in der APIKey Ihres Projekts konfiguriert ist. Es definiert, was Unico in jedem Prozess ausführt und wie die Ergebnisse im einzelnen `result` konsolidiert werden — Sie müssen auf Ihrer Seite nichts orchestrieren. Unico pflegt einen Katalog vordefinierter, benannter und versionierter Recipes (z. B. `byunico-idlive-idunico-oneresponse-std`). Einige sind exklusiv für Brasilien, etwa solche, die Score, Serpro oder Altersverifizierung einschließen. Welche Fähigkeiten führt Ihr Prozess aus?Die Kombination von Fähigkeiten — der Flow Ihres Projekts — wird in Ihrer APIKey-Konfiguration festgelegt. Prüfen Sie die vordefinierten Recipes oder wenden Sie sich an Ihren Unico-Projektansprechpartner, um sie anzupassen.Zuletzt aktualisiert am 8. Okt. 2026**