> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Betrugsprüfung abrufen > Mit Didit das gespeicherte Ergebnis einer Betrugsprüfung abrufen, die zu Ihrer Anwendung gehört. Gespeichert ist das Ergebnis dieser Prüfung. Rufen Sie eine abgeschlossene Prüfung mit den Zugangsdaten derselben Anwendung ab. Die Antwort ist das gespeicherte Ausführungsergebnis. Der Abruf führt keine Prüfungen erneut aus und verursacht keine weitere Gebühr. Der aktuelle Freigabezugriff gilt für globale Netzwerknachweise: Nach dem Widerruf des Zugriffs sind geteilte Aggregate und die daraus abgeleiteten Risikonachweise ausgeblendet. Die historische Empfehlung bleibt erhalten. Eine unbekannte, nicht abgeschlossene oder gelöschte Prüfung liefert `404` zurück. Eine Prüfung, die zu einer anderen Anwendung gehört, liefert ebenfalls `404` zurück. ## OpenAPI ````yaml de/openapi-25.json GET /v3/fraud/checks/{check_id}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/fraud/checks/{check_id}/: get: tags: - Fraud Check summary: Eine Betrugsprüfung abrufen description: Ruft eine zuvor erstellte Prüfung anhand ihrer `check_id` ab. operationId: root_retrieve parameters: - in: path name: check_id schema: type: string format: uuid required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/FraudCheckResponse' description: '' '401': content: application/json: schema: $ref: '#/components/schemas/FraudClientCredentialsErrorMessage' description: '' '403': content: application/json: schema: $ref: >- #/components/schemas/FraudClientCredentialsForbiddenErrorMessage description: '' security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.fraud_checks.retrieve( "11111111-2222-3333-4444-555555555555", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.fraudChecks.retrieve("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.FraudChecks.Retrieve(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.fraudChecks().retrieve("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- fraudChecks->retrieve('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.fraud_checks.retrieve("11111111-2222-3333-4444-555555555555") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.FraudChecks.RetrieveAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: FraudCheckResponse: type: object properties: check_id: type: string format: uuid request_id: type: string format: uuid description: Native-Verifizierungssitzung, die für diese Prüfung erstellt wurde. client_reference: type: string nullable: true processing_status: $ref: '#/components/schemas/FraudProcessingStatusEnum' profile_id: type: string profile_version: type: string created_at: type: string format: date-time completed_at: type: string format: date-time nullable: true inputs: type: array items: $ref: '#/components/schemas/FraudCheckInput' modules: type: array items: $ref: '#/components/schemas/FraudCheckModuleReport' attribute_evidence: type: array items: type: object additionalProperties: {} compound_evidence: type: array items: type: object additionalProperties: {} risk: type: array items: $ref: '#/components/schemas/FraudCheckRisk' network: type: object additionalProperties: {} enrichment: type: object additionalProperties: {} identity_relationship: allOf: - $ref: '#/components/schemas/FraudCheckIdentityRelationship' nullable: true recommendation: $ref: '#/components/schemas/FraudRecommendationEnum' next_action: $ref: '#/components/schemas/FraudNextActionEnum' decision_reasons: type: array items: type: string coverage: type: object additionalProperties: {} usage: type: array items: type: object additionalProperties: {} vendor_data: type: string nullable: true metadata: nullable: true required: - attribute_evidence - check_id - client_reference - completed_at - compound_evidence - coverage - created_at - decision_reasons - inputs - modules - network - next_action - processing_status - profile_id - profile_version - recommendation - risk - usage FraudClientCredentialsErrorMessage: type: object properties: detail: type: string default: 'Authentication failed: Invalid client access token.' FraudClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission FraudProcessingStatusEnum: enum: - pending - running - completed - failed type: string description: |- * `pending` - Ausstehend * `running` - Wird ausgeführt * `completed` - Abgeschlossen * `failed` - Fehlgeschlagen FraudCheckInput: type: object properties: reference: type: string description: Geschwärzter Handle für die übermittelte Kennung. type: $ref: '#/components/schemas/FraudTypeEnum' namespace: type: object additionalProperties: {} quality: type: string normalization: type: object additionalProperties: {} availability: $ref: '#/components/schemas/FraudAvailabilityEnum' required: - availability - namespace - normalization - quality - reference - type FraudCheckModuleReport: type: object properties: module: $ref: '#/components/schemas/FraudExcludeEnum' status: $ref: '#/components/schemas/FraudStatusEnum' reason: type: string nullable: true latency_ms: type: integer freshness: type: string nullable: true billable_units: type: integer required: - billable_units - freshness - latency_ms - module - reason - status FraudCheckRisk: type: object properties: dimension: $ref: '#/components/schemas/FraudDimensionEnum' score: type: integer nullable: true band: $ref: '#/components/schemas/FraudBandEnum' availability: $ref: '#/components/schemas/FraudAvailabilityEnum' requested_but_unavailable: type: boolean description: >- True, wenn die Anfrage alles bereitgestellt hat, was diese Dimension benötigte, und die Plattform sie dennoch nicht beantworten konnte. Eine solche Prüfung wird niemals allein aufgrund der Dimensionen zur Genehmigung empfohlen, die beantwortet werden konnten. reason_codes: type: array items: type: string evidence_indexes: type: array items: type: integer required: - availability - band - dimension - evidence_indexes - reason_codes - requested_but_unavailable - score FraudCheckIdentityRelationship: type: object properties: result: $ref: '#/components/schemas/FraudResultEnum' reference_type: type: string country: type: string availability: $ref: '#/components/schemas/FraudAvailabilityEnum' reason_codes: type: array items: type: string required: - availability - country - reason_codes - reference_type - result FraudRecommendationEnum: enum: - approve - review - reject type: string description: |- * `approve` - Genehmigen * `review` - Prüfen * `reject` - Ablehnen FraudNextActionEnum: enum: - none - manual_review - step_up - resubmit_capture type: string description: |- * `none` - Keine * `manual_review` - Manuelle Prüfung * `step_up` - Step-Up * `resubmit_capture` - Erneute Erfassung einreichen FraudTypeEnum: enum: - email - phone - national_id - tax_number - passport_number - driving_licence_number - residence_permit_number - voter_id - external_id type: string description: |- * `email` - E-Mail * `phone` - Telefon * `national_id` - Nationale ID * `tax_number` - Steuernummer * `passport_number` - Reisepassnummer * `driving_licence_number` - Führerscheinnummer * `residence_permit_number` - Aufenthaltstitelnummer * `voter_id` - Wähler-ID * `external_id` - Externe ID FraudAvailabilityEnum: enum: - available - not_requested - no_reference - insufficient_history - unsupported_region - source_unavailable type: string description: |- * `available` - Verfügbar * `not_requested` - Nicht angefragt * `no_reference` - Keine Referenz * `insufficient_history` - Unzureichender Verlauf * `unsupported_region` - Nicht unterstützte Region * `source_unavailable` - Quelle nicht verfügbar FraudExcludeEnum: enum: - normalization - email_risk - email_social - phone_social - phone_risk - ip_risk - database_validation - networks_same_org - networks_cross_org - biometric_identity type: string description: |- * `normalization` - Normalisierung * `email_risk` - E-Mail-Risiko * `email_social` - E-Mail-Social * `phone_social` - Telefon-Social * `phone_risk` - Telefonrisiko * `ip_risk` - IP-Risiko * `database_validation` - Datenbankvalidierung * `networks_same_org` - Netzwerke derselben Organisation * `networks_cross_org` - Organisationsübergreifende Netzwerke * `biometric_identity` - Biometrische Identität FraudStatusEnum: enum: - planned - completed - skipped - failed type: string description: |- * `planned` - Geplant * `completed` - Abgeschlossen * `skipped` - Übersprungen * `failed` - Fehlgeschlagen FraudDimensionEnum: enum: - identity - contact - device_network - behavioral - fraud_network type: string description: |- * `identity` - Identität * `contact` - Kontakt * `device_network` - Gerätenetzwerk * `behavioral` - Verhalten * `fraud_network` - Betrugsnetzwerk FraudBandEnum: enum: - low - medium - high - unknown type: string description: |- * `low` - Niedrig * `medium` - Mittel * `high` - Hoch * `unknown` - Unbekannt FraudResultEnum: enum: - match - mismatch - inconclusive - no_reference type: string description: |- * `match` - Übereinstimmung * `mismatch` - Keine Übereinstimmung * `inconclusive` - Nicht eindeutig * `no_reference` - Keine Referenz securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Das Client-Credentials-Zugriffstoken der Anwendung. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.