> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter URL de Verificação KYC

> Recuperar a URL de verificação para compartilhar com seu cliente — na API KYC da gu1 para fluxos de verificação de identidade, com exemplos para get kyc url.

## Resumo

Após criar uma validação KYC, você pode recuperar a URL de verificação a qualquer momento. Esta URL é o que você compartilhará com seu cliente para que ele complete o processo de verificação de identidade.

## Quando Usar Isso

* **Recuperar URL depois**: Se você não salvou a URL da resposta de criação
* **Reenviar ao cliente**: Quando o cliente solicita um novo link
* **Verificar detalhes**: Ver status atual e metadata
* **Integrar com outros sistemas**: Passar a URL para serviços de notificação

## Solicitação

### Endpoint

```
GET https://api.gu1.ai/api/kyc/validations/{id}
```

### Valores possíveis de status

O campo `status` pode ser: `pending`, `in_progress`, `in_review`, `approved`, `rejected`, `expired`, `abandoned`, `cancelled`. Consulte [Verificar status](/pt/use-cases/kyc/check-status) para a descrição de cada um.

## Exemplo

<CodeGroup>
  ```javascript Node.js theme={null}
  const validationId = '550e8400-e29b-41d4-a716-446655440000';

  const response = await fetch(
    `https://api.gu1.ai/api/kyc/validations/${validationId}`,
    {
      headers: {
        'Authorization': 'Bearer SUA_API_KEY'
      }
    }
  );

  const validation = await response.json();
  const urlVerificacao = validation.providerSessionUrl;
  console.log('Compartilhe esta URL com seu cliente:', urlVerificacao);
  ```

  ```python Python theme={null}
  validation_id = '550e8400-e29b-41d4-a716-446655440000'

  response = requests.get(
      f'https://api.gu1.ai/api/kyc/validations/{validation_id}',
      headers={'Authorization': 'Bearer SUA_API_KEY'}
  )

  validation = response.json()
  url_verificacao = validation['providerSessionUrl']
  print('Compartilhe esta URL com seu cliente:', url_verificacao)
  ```
</CodeGroup>

## Alternativa: Obter Validação Atual por Entidade

```
GET https://api.gu1.ai/api/kyc/entities/{entityId}/current
```

## Compartilhar a URL com Clientes

### Exemplo de Email

```html theme={null}
<p>Olá {{nomeCliente}},</p>
<p>Por favor complete sua verificação de identidade para continuar:</p>
<p><a href="{{providerSessionUrl}}">Verificar Sua Identidade</a></p>
<p>Este link expirará em 7 dias.</p>
```

### Integração em App

```javascript theme={null}
// Redirecionar usuário para verificação
window.location.href = providerSessionUrl;

// Ou abrir em nova janela
window.open(providerSessionUrl, '_blank');
```

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Integração Webhook" icon="webhook" href="/pt/use-cases/kyc/webhook-integration">
    Receber atualizações em tempo real
  </Card>

  <Card title="Verificar Status" icon="magnifying-glass" href="/pt/use-cases/kyc/check-status">
    Consultar resultados de validação
  </Card>
</CardGroup>