Retrieve KYC/KYB verification status
Entorno sandbox
https://sandbox.cryptopocket.io/api
Entorno sandbox
https://sandbox.cryptopocket.io/api
GET
/kyc/check
Summary
Description
person → respuesta con campos kyc_*company → respuesta con campos kyb_*Nota: Este endpoint no inicia ni reinicia ningún proceso de verificación. Para iniciar KYC usa POST /api/kyc/start. Para registrar una empresa usaPOST /api/register/company.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
user_id | integer | Yes | ID interno del usuario/cliente a consultar |
Example Request
GET /api/kyc/check?user_id=1234Respuestas para personas físicas
KYC verificado
{
"status": "success",
"kyc_status": "valid"
}KYC rechazado
{
"status": "success",
"kyc_status": "fail",
"kyc_rejected_reason": "Documento ilegible",
"kyc_url": "https://kyc.example.com/form/abc123"
}KYC en proceso u otro estado
{
"status": "success",
"kyc_status": "pending",
"kyc_url": "https://kyc.example.com/form/abc123"
}Valores posibles de kyc_status
| Valor | Descripción |
|---|---|
valid | KYC completado y verificado |
fail | KYC rechazado |
pending | KYC en revisión |
unused | KYC no iniciado |
| Otros | Estado intermedio según el proveedor KYC |
Campos adicionales (personas)
| Campo | Descripción |
|---|---|
kyc_url | URL del formulario KYC (cuando aplica) |
kyc_rejected_reason | Motivo del rechazo (solo si kyc_status = fail) |
Respuestas para empresas
KYB aceptado
{
"status": "success",
"kyb_status": "accepted"
}KYB en borrador o en revisión
{
"status": "success",
"kyb_status": "draft",
"kyb_link": "https://b2b.example.com/kyb/550e8400-e29b-41d4-a716-446655440000"
}{
"status": "success",
"kyb_status": "on_revision",
"kyb_link": "https://b2b.example.com/kyb/550e8400-e29b-41d4-a716-446655440000"
}KYB rechazado
{
"status": "success",
"kyb_status": "rejected",
"kyb_rejected_reason": "Documentación incompleta",
"kyb_link": "https://b2b.example.com/kyb/550e8400-e29b-41d4-a716-446655440000"
}Sin proceso KYB iniciado
{
"status": "success",
"kyb_status": "unused"
}Valores posibles de kyb_status
| Valor | Descripción |
|---|---|
accepted | KYB aprobado por el equipo de compliance |
rejected | KYB rechazado. El cliente puede corregir y reenviar |
on_revision | Formulario KYB enviado, pendiente de revisión interna |
draft | Registro creado, formulario KYB no completado o no enviado |
unused | Usuario empresa sin registro KYB asociado |
Campos adicionales (empresas)
| Campo | Descripción |
|---|---|
kyb_link | URL pública del formulario KYB. Se incluye si existe un enlace válido y no expirado (no revocado, dentro de los 90 días) |
kyb_rejected_reason | Motivo del rechazo (solo si kyb_status = rejected) |
Errores
user_id no proporcionado
{
"status": "error",
"error": "fail_mandatory_field",
"message": "Not user_id provided"
}Usuario no encontrado
{
"status": "error",
"error": "user_not_found"
}Flujo recomendado
Persona física:
POST /kyc/start → GET /kyc/check → kyc_status: valid
Empresa:
POST /register/company → GET /kyc/check → kyb_status: acceptedSolicitud
Parámetros de consulta
Parámetros del Body application/x-www-form-urlencoded
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox.cryptopocket.io/api/kyc/check?user_id='Respuesta Ejemplo de Respuesta
SUCCESS
{
"status": "success",
"kyc_status": "valid"
}Modificado en 2026-06-26 01:40:41