Endpoints

Validación rápida

Confirma que la cédula existe y te devuelve el nombre del titular. Es sincrónica y suele responder en unos 5 segundos. Equivale a POST /v1/searches con endpoint=identity_validation, pero es más cómoda si tu flujo solo hace GET.

GET/v1/identity-validation/{cedula}

Path

ParámetroTipoDescripción
cedularequeridostringCédula del sujeto a validar.

Query params

ParámetroTipoDescripción
purposestringPropósito (kyc, onboarding, etc).
consent_referencestringReferencia del consentimiento del titular en tu sistema.

Ejemplo

curlbash
curl https://api.empresas.tverificas.com/v1/identity-validation/1234567890 \
  -H "Authorization: Bearer $TVERIFICAS_API_KEY"

Respuesta

Mismo shape que POST /v1/searches con endpoint: "identity_validation". En response_data viene la identidad confirmada:

json
"response_data": {
  "cedula": "1234567890",
  "nombre": "NOMBRE COMPLETO DEL TITULAR",
  "nacionalidad": "Colombia",
  "tipo_documento": "Cedula de Ciudadania (C.C.)",
  "status": "validated",
  "source": "Procuraduria_HTTP",
  "duration_ms": 3951
}

Si ninguna fuente logra confirmar la cédula (no existe o las fuentes no respondieron), la búsqueda queda en failed y no se cobra.