Empieza acá

Quickstart.

Tu primera verificación en cinco minutos. Asume que ya tienes una API key — si no, solicita acceso desde el dashboard.

1. Guarda tu key como variable de entorno

.envbash

TVERIFICAS_API_KEY=tvk_test_xxxxxxxxxxxxx

2. Confirma que estás autenticado

curlbash

curl https://api.tverificas.com/v1/me \
  -H "Authorization: Bearer $TVERIFICAS_API_KEY"

Esto devuelve los datos de tu organización y el tipo de key (live o test).

3. Lanza una validación rápida

Para probar sin gastar cuota, usa el endpoint sincrónico de validación rápida:

GET /v1/identity-validationbash

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

Respuesta similar a:

json

{
  "id": "9cf1dc24-…",
  "endpoint": "identity_validation",
  "status": "completed",
  "mode": "test",
  "cedula_raw": "1020487456",
  "sources_total": 4,
  "sources_ok": 4,
  "duration_ms": 4820,
  "response_data": { ... }
}

4. Lanza una verificación a fondo

Para correr el endpoint full_check (identidad + 10 scrapers + 35 bases de datos), usa el POST:

POST /v1/searchesbash

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

Por default POST /v1/searches es sincrónico y bloquea hasta que termine. La respuesta del POST ya trae el resultado.

5. Modo asíncrono (cargas grandes)

Para cargas que pueden tardar minutos, pasa ?async=true y consulta el estado por separado.

POST asyncbash

curl -X POST "https://api.tverificas.com/v1/searches?async=true" \
  -H "Authorization: Bearer $TVERIFICAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cedula": "1020487456",
    "endpoint": "full_check",
    "purpose": "kyc"
  }'

Respuesta inmediata 202 Accepted con el id de la búsqueda en estado pending:

json

{
  "id": "9cf1dc24-193b-4c73-8672-1562daa53d7c",
  "status": "pending",
  "mode": "live",
  "cedula_raw": "1020487456",
  "endpoint": "full_check",
  "created_at": "2026-04-28T14:08:33Z"
}

Consulta el estado cada 1-2 segundos hasta que termine:

GET /v1/searches/{id}bash

curl "https://api.tverificas.com/v1/searches/9cf1dc24-193b-4c73-8672-1562daa53d7c" \
  -H "Authorization: Bearer $TVERIFICAS_API_KEY"

El polling termina cuando status es completed, degraded o failed. Patrón completo de polling con código JS en Estado de búsqueda.

6. Próximos pasos

Lee el detalle de cada endpoint en la sidebar.
Configura Idempotency-Key en producción para no cobrar dos veces por la misma operación.
Ten en cuenta los códigos de error en /docs/errors.