Verifiquemos

Para desarrolladores

Integre cumplimiento KYC en minutos, no en meses.

API REST con autenticación por API key. RENAP, OFAC, ONU, Lista Engel, PEP y CPE en una sola llamada. Score de riesgo con AI, PDF firmado y webhook de resultados. Todo en español, con soporte directo en Guatemala.

Crear cuenta gratis Ver Referencia de API

Cuenta gratis · Sin tarjeta de crédito

Primera validación 
curl -X POST https://api.verifiquemos.com/external/v1/validations \
  -H "x-api-key: vfq_YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "naturaleza": "persona_individual",
    "cui": "1234567890101",
    "tipo_cliente": "individual_nacional_renap",
    "actividad_economica": "comercio_general",
    "producto_servicio": "cuentas_pasivas",
    "perfil_ingreso": "ingresos_medios"
  }'

Empieza en 3 pasos

De cero a primera validación en menos de 5 minutos.

  1. 1

    Cree su cuenta

    Regístrese con email y contraseña. Cada validación consume 1 consulta.

    Crear cuenta
  2. 2

    Genere una API key

    Desde Configuración → API Keys, emita una key. Se muestra una sola vez: guárdela en su gestor de secretos.

    Ir a configuración
  3. 3

    Haga su primera llamada

    Envíe un POST a /external/v1/validations con los datos del cliente, autenticado con el header x-api-key: su API key. Recibe un id para hacer polling. En 30-60s tiene el reporte completo.

    Ver ejemplos Ver referencia completa del API

Ejemplos de código

Crear una validación KYC. Copie, pegue, reemplace la API key y ya está.

cURL · terminal 
curl -X POST https://api.verifiquemos.com/external/v1/validations \
  -H "x-api-key: vfq_YOUR_API_KEY_HERE" \
  -H "Idempotency-Key: 01HKEY00000000000000000000" \
  -H "Content-Type: application/json" \
  -d '{
    "naturaleza": "persona_individual",
    "cui": "1234567890101",
    "tipo_cliente": "individual_nacional_renap",
    "actividad_economica": "comercio_general",
    "producto_servicio": "cuentas_pasivas",
    "perfil_ingreso": "ingresos_medios"
  }'
Python · validate.py 
import httpx
from ulid import new as new_ulid

api_key = "vfq_YOUR_API_KEY_HERE"

response = httpx.post(
    "https://api.verifiquemos.com/external/v1/validations",
    headers={
        "x-api-key": api_key,
        "Idempotency-Key": str(new_ulid()),
    },
    json={
        "naturaleza": "persona_individual",
        "cui": "1234567890101",
        "tipo_cliente": "individual_nacional_renap",
        "actividad_economica": "comercio_general",
        "producto_servicio": "cuentas_pasivas",
        "perfil_ingreso": "ingresos_medios",
    },
    timeout=30.0,
)
response.raise_for_status()
validation = response.json()
print(f"Validation submitted: {validation['id']}")
TypeScript · validate.ts 
import { ulid } from "ulid";

const apiKey = "vfq_YOUR_API_KEY_HERE";

const response = await fetch("https://api.verifiquemos.com/external/v1/validations", {
  method: "POST",
  headers: {
    "x-api-key": apiKey,
    "Idempotency-Key": ulid(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    naturaleza: "persona_individual",
    cui: "1234567890101",
    tipo_cliente: "individual_nacional_renap",
    actividad_economica: "comercio_general",
    producto_servicio: "cuentas_pasivas",
    perfil_ingreso: "ingresos_medios",
  }),
});

if (!response.ok) {
  throw new Error(`Validation failed: ${response.status} ${await response.text()}`);
}
const validation = await response.json();
console.log(`Validation submitted: ${validation.id}`);

¿Qué pasa después?

El POST devuelve { id, status: "pending" }. Haga polling cada 2-3s a GET /external/v1/validations/{validation_id} hasta un estado terminal: completed, completed_partial o failed. La URL del PDF firmado se obtiene de GET /external/v1/validations/{validation_id}/report. Las claves de catálogo (tipo_cliente, actividad_economica, producto_servicio, perfil_ingreso) se consultan en GET /external/v1/catalogs/*.

Endpoints principales

La superficie completa del API externo. Parámetros y esquemas en la Referencia de API.

Método Ruta Descripción
POST /external/v1/validations Crea una validación KYC. Body JSON con naturaleza, identificación (CUI o NIT) y claves de catálogo.
GET /external/v1/validations Lista las validaciones del tenant autenticado.
GET /external/v1/validations/{validation_id} Estado y resultados. Polling hasta status='completed'.
GET /external/v1/validations/{validation_id}/report URL del reporte PDF firmado con score de riesgo y factores.
POST /external/v1/validations/{validation_id}/cancel Cancela una validación en curso.
GET /external/v1/countries Catálogo de países; /sanctioned devuelve solo los sancionados (OFAC / GAFI).
GET /external/v1/catalogs/* Catálogos de claves: naturalezas, tipos-cliente, actividades-economicas, productos-servicios, perfiles-ingreso.

Ver parámetros, esquemas y ejemplos en la Referencia de API.

¿Listo para empezar?

Cree su cuenta gratis y comience en menos de 5 minutos. Sin tarjeta de crédito, sin contratos.

Crear cuenta gratis Hablar con ventas