> ## 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. # Récupérer un contrôle antifraude > Didit vous permet de récupérer le résultat stocké d'un contrôle antifraude (Fraud Check) appartenant à votre application. Récupérez un contrôle terminé à l'aide des identifiants de la même application. La réponse est le résultat d'exécution enregistré : la récupération ne relance pas les contrôles et n'entraîne pas de nouveaux frais. L'accès de partage en vigueur s'applique aux preuves du réseau mondial : une fois l'accès révoqué, les agrégats partagés et les preuves de risque qui en découlent sont masqués. La recommandation historique est conservée. Un contrôle inconnu, inachevé ou supprimé renvoie `404`. Un contrôle appartenant à une autre application renvoie également `404`. ## OpenAPI ````yaml fr/openapi-25.json GET /v3/fraud/checks/{check_id}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/fraud/checks/{check_id}/: get: tags: - Fraud Check summary: Récupérer un contrôle de fraude description: Récupérer une vérification préalablement créée grâce à son `check_id`. 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: Session de vérification native créée pour cette vérification. 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` - En attente * `running` - En cours d'exécution * `completed` - Terminé * `failed` - Échoué FraudCheckInput: type: object properties: reference: type: string description: Identifiant masqué pour l'identifiant transmis. 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: >- Vrai lorsque la requête a fourni tout ce dont cette dimension avait besoin et que la plateforme n'a tout de même pas pu y répondre. Une telle vérification n'est jamais recommandée pour approbation sur la seule base des dimensions ayant répondu. 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` - Approuver * `review` - Examiner * `reject` - Rejeter FraudNextActionEnum: enum: - none - manual_review - step_up - resubmit_capture type: string description: |- * `none` - Aucun * `manual_review` - Examen manuel * `step_up` - Vérification renforcée * `resubmit_capture` - Resoumettre la capture 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` - Téléphone * `national_id` - Identifiant national * `tax_number` - Identifiant fiscal * `passport_number` - Numéro de passeport * `driving_licence_number` - Numéro de permis de conduire * `residence_permit_number` - Numéro de titre de séjour * `voter_id` - Identifiant d'électeur * `external_id` - Identifiant externe FraudAvailabilityEnum: enum: - available - not_requested - no_reference - insufficient_history - unsupported_region - source_unavailable type: string description: |- * `available` - Disponible * `not_requested` - Non demandé * `no_reference` - Aucune référence * `insufficient_history` - Historique insuffisant * `unsupported_region` - Région non prise en charge * `source_unavailable` - Source indisponible 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` - Normalisation * `email_risk` - Risque lié à l'e-mail * `email_social` - Réseaux sociaux de l'e-mail * `phone_social` - Réseaux sociaux du téléphone * `phone_risk` - Risque lié au téléphone * `ip_risk` - Risque lié à l'IP * `database_validation` - Validation en base de données * `networks_same_org` - Réseaux au sein de la même organisation * `networks_cross_org` - Réseaux inter-organisations * `biometric_identity` - Identité biométrique FraudStatusEnum: enum: - planned - completed - skipped - failed type: string description: |- * `planned` - Planifié * `completed` - Terminé * `skipped` - Ignoré * `failed` - Échoué FraudDimensionEnum: enum: - identity - contact - device_network - behavioral - fraud_network type: string description: |- * `identity` - Identité * `contact` - Contact * `device_network` - Réseau de l'appareil * `behavioral` - Comportemental * `fraud_network` - Réseau de fraude FraudBandEnum: enum: - low - medium - high - unknown type: string description: |- * `low` - Faible * `medium` - Moyen * `high` - Élevé * `unknown` - Inconnu FraudResultEnum: enum: - match - mismatch - inconclusive - no_reference type: string description: |- * `match` - Correspondance * `mismatch` - Non-correspondance * `inconclusive` - Non concluant * `no_reference` - Aucune référence securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Le token d'accès client-credentials de l'application. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.