> ## 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.

# Obtener URL de Verificación KYC

> Recuperar la URL de verificación para compartir con tu cliente — en la API KYC de gu1 para flujos de verificación de identidad, con ejemplos para get kyc url.

## Resumen

Después de crear una validación KYC, puedes recuperar la URL de verificación en cualquier momento. Esta URL es la que compartirás con tu cliente para que complete el proceso de verificación de identidad.

## Cuándo Usar Esto

* **Recuperar URL después**: Si no guardaste la URL de la respuesta de creación
* **Reenviar al cliente**: Cuando el cliente solicita un nuevo enlace
* **Verificar detalles**: Ver estado actual y metadata
* **Integrar con otros sistemas**: Pasar la URL a servicios de notificación

## Solicitud

### Endpoint

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

### Parámetros de Ruta

<ParamField path="id" type="string" required>
  El ID de validación devuelto al crear la validación KYC
</ParamField>

## Respuesta

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "entityId": "123e4567-e89b-12d3-a456-426614174000",
  "providerSessionUrl": "https://verify.example.com/session_xyz789",
  "status": "pending",
  
  "isCurrent": true,
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-15T10:30:00Z"
}
```

### Valores posibles de status

El campo `status` puede ser: `pending`, `in_progress`, `in_review`, `approved`, `rejected`, `expired`, `abandoned`, `cancelled`. Consulta [Verificar estado](/es/use-cases/kyc/check-status) para la descripción de cada uno.

## Ejemplo

<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 TU_API_KEY'
      }
    }
  );

  const validation = await response.json();
  const urlVerificacion = validation.providerSessionUrl;
  console.log('Comparte esta URL con tu cliente:', urlVerificacion);
  ```

  ```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 TU_API_KEY'}
  )

  validation = response.json()
  url_verificacion = validation['providerSessionUrl']
  print('Comparte esta URL con tu cliente:', url_verificacion)
  ```
</CodeGroup>

## Alternativa: Obtener Validación Actual por Entidad

Si no tienes el ID de validación pero tienes el ID de entidad:

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

## Compartir la URL con Clientes

### Ejemplo de Email

```html theme={null}
<p>Hola {{nombreCliente}},</p>
<p>Por favor completa tu verificación de identidad para continuar:</p>
<p><a href="{{providerSessionUrl}}">Verificar Tu Identidad</a></p>
<p>Este enlace expirará en 7 días.</p>
```

### Ejemplo de SMS

```
Completa tu verificación de identidad aquí: {{providerSessionUrl}}
```

### Integración en App

```javascript theme={null}
// Redirigir usuario a verificación
window.location.href = providerSessionUrl;

// O abrir en nueva ventana
window.open(providerSessionUrl, '_blank');

// O embeber en iframe
<iframe src={providerSessionUrl} width="100%" height="600px" />
```

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Integración Webhook" icon="webhook" href="/es/use-cases/kyc/webhook-integration">
    Recibir actualizaciones en tiempo real
  </Card>

  <Card title="Verificar Estado" icon="magnifying-glass" href="/es/use-cases/kyc/check-status">
    Consultar resultados de validación
  </Card>
</CardGroup>