# API para desarrolladores

Integre el screening de cumplimiento en cualquier flujo de trabajo

Su pipeline de incorporación, pasarela de pagos y CRM ya gestionan decisiones de riesgo cada día. La API de ScreenVeritAI le permite integrar screening de sanciones, verificaciones de PEP, análisis de medios adversos y mapeo de titularidad real directamente en esos flujos de trabajo — sin consultas manuales, sin copiar y pegar, sin brechas de cumplimiento entre sistemas. Una sola llamada a la API activa el mismo agente de IA que impulsa nuestra plataforma, y el JSON estructurado regresa listo para su motor de decisiones.

Obtener clave API Ver precios

// The request

One POST call. That's your entire integration.

Entity name, country, screening profile. Send it. The AI agent takes it from there — no orchestration logic on your end.

nameEntity name, alias-aware

countryISO 3166-1 alpha-2 country code

profile"sanctions_check" or "deep_research"

POST /v1/screenbash

1curl -X POST https://api.screenveritai.com/v1/screen \

2 -H 'Authorization: Bearer YOUR_API_KEY' \

3 -H 'Content-Type: application/json' \

4 -d '{

5 "name": "Acme Trading LLC",

6 "country": "AE",

7 "profile": "deep_research"

8 }'

POST /api/v1/screen — response200 OK

2"entity": "Acme Trading LLC",

3"request_id": "srv_a8f3c1d9",

4"processed_at": "2026-03-26T09:14:02Z",

5"sanctions": {

6"status": "clear",

7"lists_checked": 10,

8"matches": []

9},

10"pep": {

11"status": "match",

12"details": "Board member linked to PEP (gov. minister spouse)"

13},

14"adverse_media": {

15"hits": 3,

16"languages": ["en", "ar", "ko"],

17"highest_severity": "medium"

18},

19"ubo": {

20"layers_traced": 3,

21"flagged": true,

22"reason": "UBO connected to sanctioned entity"

23},

24"risk_tier": "enhanced_due_diligence"

25}

Clear / pass

Match / flagged

Hits / warnings

Counts / metadata

// The response

Structured JSON. Every risk vector. Color-coded.

Sanctions status, PEP matches, adverse media hits, UBO flags, and risk tier — all in one response, ready for your decision engine.

"sanctions"Direct list match status + count

"pep"PEP match + relationship detail

"adverse_media"Hit count, languages, severity

"ubo"Layers traced + flagged indicator

"risk_tier"Normalized risk classification

// Endpoints

API Reference

Three endpoints cover all screening workflows.

POST

/v1/screen

Submit an entity for sanctions, PEP, adverse media, and UBO screening.

Request

curl -X POST https://api.screenveritai.com/v1/screen \

-H 'Authorization: Bearer {API_KEY}' \

-d '{"name": "Acme LLC", "country": "AE", "profile": "deep_research"}'

Response

200 OK

{ "request_id": "srv_a8f3c1d9", "status": "queued",

"estimated_seconds": 30, "poll_url": "/v1/result/srv_a8f3c1d9" }

// Integration patterns

Drop into your existing workflow

The API sits between data entry and decision — wherever you need a risk signal.

Customer onboarding

Customer signupPOST /v1/screenDecision engineApprove / reject

Payment processing

Transaction initGET /v1/checkScreen counterpartyRelease / hold

CRM re-trigger

Record updatedWebhook firesPOST /v1/screenAlert if changed

// Build vs buy

Desarrollar vs. comprar

Aspecto	Desarrollo interno	API de ScreenVeritAI
Tiempo hasta producción	6-12 meses para obtener listas, construir lógica de coincidencia y manejar casos límite	Días para integrar; listo para producción desde la primera llamada a la API
Cobertura de listas de sanciones	Ingesta manual de cada formato de lista; mantenimiento continuo a medida que cambian los esquemas	Más de 10 regímenes mantenidos y actualizados continuamente — OFAC, UE, ONU, Reino Unido y más
Precisión de coincidencia	La coincidencia difusa personalizada requiere experiencia en NLP y ajuste continuo	Agente de IA con coincidencia difusa, transliteración, resolución de alias y algoritmos fonéticos
PEP y medios adversos	Proveedores de datos separados, integraciones separadas, presupuestos separados	Datos de PEP, medios adversos y titularidad real incluidos en la misma respuesta de API
Mantenimiento continuo	Equipo de ingeniería dedicado para actualizaciones de listas, cambios de esquema y ajuste de falsos positivos	Totalmente gestionado — actualizaciones de listas, mejoras de modelos e infraestructura gestionadas por usted
Pista de auditoría	Construya su propia infraestructura de registro, generación de evidencia y retención	Paquetes de evidencia con marca de tiempo con referencias de fuentes y fundamento de decisión incluidos

// How it works

Cuatro pasos a producción

Obtenga su clave API

Cree una clave API con alcance limitado desde su panel de ScreenVeritAI. Asigne permisos — search:read, search:write, batch:read, batch:write — para acceso con privilegios mínimos.

Integre el endpoint

Agregue una sola llamada POST a su flujo de incorporación, pagos o CRM. Envíe el nombre de la entidad, tipo y país. La API devuelve un ID de trabajo para la recuperación asíncrona de resultados.

Procese los resultados

Consulte el endpoint de resultados o reciba una callback por webhook. Analice la respuesta JSON estructurada — coincidencias de sanciones, alertas de PEP, hallazgos de medios adversos y puntuaciones de riesgo — y diríjalos a su lógica de decisión.

Monitoree y alerte

Configure el monitoreo continuo para las entidades verificadas. Cuando se actualicen las listas de sanciones o surjan nuevos medios adversos, la API envía alertas para que su sistema pueda activar el re-screening automáticamente.

// Quickstart examples

Comience en minutos

Una sola llamada a la API devuelve un resultado completo de screening.

Verificar una entidadbash

bash

curl -X POST https://api.screenveritai.com/v1/screen \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Acme Trading LLC", "country": "AE"}'

Consultar resultadobash

bash

curl https://api.screenveritai.com/v1/results/RESULT_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

Rendimiento de la API

10+

Regímenes globales de sanciones verificados por llamada a la API

<2 min

Tiempo de respuesta promedio para un screening completo con investigación profunda

99.9%

SLA de disponibilidad de la API para integraciones en producción

// FAQ

Preguntas frecuentes sobre integración API

#¿Cómo autentico las solicitudes de API?

Todas las solicitudes de API se autentican usando una clave API pasada en el encabezado Authorization. Las claves se crean desde su panel de ScreenVeritAI con permisos de alcance limitado (search:read, search:write, batch:read, batch:write) para aplicar acceso con privilegios mínimos.

#¿La API es síncrona o asíncrona?

La API utiliza un modelo de procesamiento asíncrono. Usted envía una solicitud de screening mediante POST y recibe un ID de trabajo de inmediato. Los resultados se recuperan consultando el endpoint de resultados o configurando una callback por webhook. Esto evita bloqueos en su pipeline de producción mientras el agente de IA completa su análisis.

#¿Qué formato de respuesta devuelve la API?

Todas las respuestas son JSON estructurado con nombres de campo y tipos consistentes. Los resultados de screening incluyen detalles de coincidencia de sanciones, alertas de PEP, hallazgos de medios adversos, puntuaciones de confianza, referencias de fuentes y clasificación de nivel de riesgo — listos para análisis automatizado y lógica de decisión sin extracción manual.

#¿Qué límites de velocidad aplican?

Los límites de velocidad se asignan por nivel de suscripción y se aplican por clave API. Los encabezados de respuesta incluyen su límite actual, cuota restante y marca de tiempo de reinicio. Si necesita mayor rendimiento para procesamiento masivo, el endpoint de lotes acepta cargas CSV/XLSX para screening de alto volumen.

#¿Puedo verificar entidades por lotes mediante la API?

Sí. El endpoint de lotes acepta archivos CSV o XLSX con hasta 100 filas por solicitud. Cada fila se procesa como un screening individual, y los resultados son recuperables por fila o como una exportación descargable completa cuando el trabajo se complete.

#¿Cómo configuro el monitoreo continuo mediante la API?

Después de un screening inicial, puede configurar el monitoreo para la entidad verificada. Cuando se actualicen las listas de sanciones o surjan nuevos medios adversos, la API envía una notificación por webhook a su endpoint configurado para que su sistema pueda activar el re-screening o la escalación automáticamente.

#¿Qué datos de cumplimiento se incluyen en cada resultado de screening?

Cada resultado incluye coincidencias de sanciones en más de 10 regímenes, estatus de PEP con conexiones de familiares y asociados, hallazgos de medios adversos con citas de fuentes multilingües, datos de titularidad real, clasificación de nivel de riesgo y un paquete de evidencia con marca de tiempo adecuado para auditoría y revisión regulatoria.

#¿Cuánto tarda un screening?

Una verificación estándar de sanciones generalmente se completa en segundos. Un screening de investigación profunda — incluyendo análisis de medios adversos y mapeo de propiedad — promedia menos de dos minutos. El modelo asíncrono significa que su sistema nunca se bloquea esperando resultados.

Terminología de API

API REST

Una arquitectura de API web que utiliza métodos HTTP estándar (GET, POST, PUT, DELETE) para interactuar con recursos. La API de ScreenVeritAI sigue las convenciones REST, haciéndola compatible con cualquier lenguaje o framework que pueda realizar solicitudes HTTP.

Webhook

Una callback HTTP de servidor a servidor activada por un evento. En lugar de consultar los resultados, puede configurar ScreenVeritAI para que envíe una solicitud POST a su endpoint cuando un screening se complete o cuando el monitoreo continuo detecte un cambio.

Procesamiento asíncrono

Un modelo de solicitud en el que la API acepta un trabajo de inmediato y lo procesa en segundo plano. El cliente recibe un ID de trabajo y recupera los resultados posteriormente mediante polling o webhook. Este patrón evita bloqueos en los pipelines de producción.

Clave API

Un token secreto utilizado para autenticar solicitudes de API de servidor a servidor. Las claves API de ScreenVeritAI tienen alcance con permisos específicos (search:read, search:write, batch:read, batch:write) para aplicar patrones de acceso con privilegios mínimos.

Limitación de velocidad

Un mecanismo que restringe el número de solicitudes de API que un cliente puede realizar dentro de un período de tiempo determinado. Los límites de velocidad se asignan por nivel de suscripción y se comunican mediante encabezados de respuesta que incluyen cuota restante y marcas de tiempo de reinicio.

Respuesta estructurada

Un formato de respuesta de API legible por máquina (JSON) con nombres de campo, tipos y anidamiento consistentes. Las respuestas estructuradas permiten el análisis automatizado, la lógica de decisión y la generación de pistas de auditoría sin extracción manual de datos.

/* Fuentes del sector */

[1]
Guía del GAFI sobre identidad digital y debida diligencia del cliente
Grupo de Acción Financiera Internacional
[2]
Tecnología regulatoria para el cumplimiento AML/CFT
Banco de Pagos Internacionales — FSI Insights
[3]
Marco de compromisos de cumplimiento de la OFAC
Departamento del Tesoro de EE. UU.
[4]
Reglamento de la Autoridad Europea de Lucha contra el Blanqueo de Capitales (AMLA)
Diario Oficial de la Unión Europea

Integre el screening de cumplimiento en cualquier flujo de trabajo

One POST call. That's your entire integration.

Structured JSON. Every risk vector. Color-coded.

API Reference

Drop into your existing workflow

Desarrollar vs. comprar

Cuatro pasos a producción

Comience en minutos

Rendimiento de la API

Preguntas frecuentes sobre integración API

Terminología de API

/* Fuentes del sector */

// Explorar más

Screening de sanciones

Screening de clientes y debida diligencia

Screening masivo

Cobertura de listas de sanciones

Comience a verificar en minutos.