tverificas.
DocumentaciónIr al dashboard →
Endpoints

Endpoint configs.

Cada llamada a POST /v1/searches recibe un parámetro `endpoint` que selecciona qué tan profunda es la consulta. Acá las tres opciones disponibles, su costo y cuándo usar cada una.

1.00 unidad

full_check

Timeout
180 segundos
Min. fuentes
10

Consulta a fondo: identidad + scrapers en vivo + bases de datos. La verificación más completa, ideal para onboarding crítico y due diligence.

0.20 unidad

identity_validation

Timeout
90 segundos
Min. fuentes
1

Race entre fuentes de identidad oficiales. Confirma que la cédula corresponde a una persona real y vigente. No incluye antecedentes ni listas de sanciones.

Cuándo usar cada uno

full_check

  • Onboarding KYC en banca, fintech y servicios regulados
  • Validación de contraparte antes de firmar contratos
  • Background check pre-contratación de cargos sensibles

identity_validation

  • Verificación de identidad en formularios públicos
  • Validación rápida sincrónica con respuesta inmediata
  • Pre-paso antes de un full_check para descartar cédulas inválidas

Cómo se selecciona

Pasa el parámetro endpoint en el body del POST /v1/searches:

bash
curl -X POST https://api.tverificas.com/v1/searches \
  -H "Authorization: Bearer $TVERIFICAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cedula": "1020487456",
    "endpoint": "identity_validation"
  }'

Si no pasas endpoint, el default es full_check.

Modo test

Las API keys tvk_test_… ejecutan el mismo flujo contra las mismas fuentes oficiales pero no descuentan cuota live. Sirven para validar tu integración con datos reales sin riesgo de sobreconsumo. El uso cuenta contra el límite de modo test (50 verificaciones por defecto).