> ## 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. # Obtenir una comprovació de frau > Consulta el resultat emmagatzemat d'una comprovació de frau de la teva aplicació amb Didit. Recupera una comprovació completada amb les credencials de la mateixa aplicació. La resposta és el resultat d'execució emmagatzemat; la recuperació no torna a executar les comprovacions ni genera un altre cobrament. L'accés vigent a la compartició s'aplica a l'evidència de la xarxa global: un cop revocat l'accés, els agregats compartits i l'evidència de risc derivada queden ocults. La recomanació històrica es conserva. Una comprovació inexistent, no finalitzada o eliminada retorna `404`. Una comprovació que pertany a una altra aplicació també retorna `404`. ## OpenAPI ````yaml ca/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 verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/fraud/checks/{check_id}/: get: tags: - Fraud Check summary: Recuperar una comprovació de frau description: Obtén una comprovació creada prèviament mitjançant el seu `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: Sessió de verificació nativa creada per a aquesta comprovació. 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` - Pendent * `running` - En execució * `completed` - Completat * `failed` - Fallit FraudCheckInput: type: object properties: reference: type: string description: Àlies ofuscat per a l'identificador enviat. 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: >- Cert quan la sol·licitud ha proporcionat tot el que aquesta dimensió necessitava i la plataforma encara no ha pogut respondre-la. Mai es recomana aprovar una comprovació d'aquest tipus basant-se en la solidesa de les dimensions que sí que han respost. 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` - Aprovar * `review` - Revisar * `reject` - Rebutjar FraudNextActionEnum: enum: - none - manual_review - step_up - resubmit_capture type: string description: |- * `none` - Cap * `manual_review` - Revisió manual * `step_up` - Verificació addicional * `resubmit_capture` - Tornar a enviar captura FraudTypeEnum: enum: - email - phone - national_id - tax_number - passport_number - driving_licence_number - residence_permit_number - voter_id - external_id type: string description: |- * `email` - Correu electrònic * `phone` - Telèfon * `national_id` - Document d'identitat nacional * `tax_number` - Identificador fiscal * `passport_number` - Número de passaport * `driving_licence_number` - Número de permís de conduir * `residence_permit_number` - Número de permís de residència * `voter_id` - Identificador de votant * `external_id` - ID extern FraudAvailabilityEnum: enum: - available - not_requested - no_reference - insufficient_history - unsupported_region - source_unavailable type: string description: |- * `available` - Disponible * `not_requested` - No sol·licitat * `no_reference` - Sense referència * `insufficient_history` - Historial insuficient * `unsupported_region` - Regió no admesa * `source_unavailable` - Font no disponible 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` - Normalització * `email_risk` - Risc de correu electrònic * `email_social` - Aspectes socials del correu electrònic * `phone_social` - Aspectes socials del telèfon * `phone_risk` - Risc de telèfon * `ip_risk` - Risc d'IP * `database_validation` - Validació en bases de dades * `networks_same_org` - Xarxes de la mateixa organització * `networks_cross_org` - Xarxes entre organitzacions * `biometric_identity` - Identitat biomètrica FraudStatusEnum: enum: - planned - completed - skipped - failed type: string description: |- * `planned` - Planificat * `completed` - Completat * `skipped` - Omès * `failed` - Fallit FraudDimensionEnum: enum: - identity - contact - device_network - behavioral - fraud_network type: string description: |- * `identity` - Identitat * `contact` - Contacte * `device_network` - Dispositiu i xarxa * `behavioral` - Conductual * `fraud_network` - Xarxa de frau FraudBandEnum: enum: - low - medium - high - unknown type: string description: |- * `low` - Baix * `medium` - Mitjà * `high` - Alt * `unknown` - Desconegut FraudResultEnum: enum: - match - mismatch - inconclusive - no_reference type: string description: |- * `match` - Coincidència * `mismatch` - Discrepància * `inconclusive` - No concloent * `no_reference` - Sense referència securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: El token d'accés de credencials de client de l'aplicació. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.