> ## 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. # Obter resultado do Fraud Check (verificação de fraude) > Recupere o resultado armazenado de um Fraud Check que pertence à sua aplicação, consultando diretamente o endpoint da API da Didit. Recupere uma verificação concluída usando as credenciais da mesma aplicação. A resposta é o resultado armazenado da execução; a recuperação não executa as verificações novamente nem gera nova cobrança. O acesso de compartilhamento vigente se aplica às evidências da rede global: após a revogação do acesso, os agregados compartilhados e as evidências de risco derivadas deles ficam ocultos. A recomendação histórica é preservada. Uma verificação desconhecida, não concluída ou excluída retorna `404`. Uma verificação que pertence a outra aplicação também retorna `404`. ## OpenAPI ````yaml pt-br/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 verificação de identidade. Autentique-se com o cabeçalho x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/fraud/checks/{check_id}/: get: tags: - Fraud Check summary: Obter uma verificação de fraude description: Obtenha uma verificação criada anteriormente pelo 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: Sessão de verificação nativa criada para esta verificação. 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` - Pendente * `running` - Em execução * `completed` - Concluído * `failed` - Falhou FraudCheckInput: type: object properties: reference: type: string description: Identificador ocultado correspondente ao identificador enviado. 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 quando a requisição forneceu tudo o que esta dimensão precisava e, mesmo assim, a plataforma não conseguiu respondê-la. Uma verificação nessa situação nunca é recomendada para aprovação com base apenas nas dimensões que responderam. 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` - Rejeitar FraudNextActionEnum: enum: - none - manual_review - step_up - resubmit_capture type: string description: |- * `none` - Nenhuma * `manual_review` - Revisão manual * `step_up` - Verificação adicional * `resubmit_capture` - Reenviar 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` - E-mail * `phone` - Telefone * `national_id` - Documento nacional de identidade * `tax_number` - Número de identificação fiscal * `passport_number` - Número do passaporte * `driving_licence_number` - Número da carteira de motorista * `residence_permit_number` - Número da autorização de residência * `voter_id` - Título de eleitor * `external_id` - ID externo FraudAvailabilityEnum: enum: - available - not_requested - no_reference - insufficient_history - unsupported_region - source_unavailable type: string description: |- * `available` - Disponível * `not_requested` - Não solicitado * `no_reference` - Sem referência * `insufficient_history` - Histórico insuficiente * `unsupported_region` - Região não suportada * `source_unavailable` - Fonte indisponível 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` - Normalização * `email_risk` - Risco de e-mail * `email_social` - Redes sociais do e-mail * `phone_social` - Redes sociais do telefone * `phone_risk` - Risco de telefone * `ip_risk` - Risco de IP * `database_validation` - Validação de banco de dados * `networks_same_org` - Redes na mesma organização * `networks_cross_org` - Redes entre organizações * `biometric_identity` - Identidade biométrica FraudStatusEnum: enum: - planned - completed - skipped - failed type: string description: |- * `planned` - Planejado * `completed` - Concluído * `skipped` - Ignorado * `failed` - Falhou FraudDimensionEnum: enum: - identity - contact - device_network - behavioral - fraud_network type: string description: |- * `identity` - Identidade * `contact` - Contato * `device_network` - Rede de dispositivos * `behavioral` - Comportamental * `fraud_network` - Rede de fraude FraudBandEnum: enum: - low - medium - high - unknown type: string description: |- * `low` - Baixo * `medium` - Médio * `high` - Alto * `unknown` - Desconhecido FraudResultEnum: enum: - match - mismatch - inconclusive - no_reference type: string description: |- * `match` - Correspondência * `mismatch` - Divergência * `inconclusive` - Inconclusivo * `no_reference` - Sem referência securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: O token de acesso de client credentials da aplicação. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.