ScreenVeritAI · API Specv1 · GA · reference
    API para desarrolladores

    ¿Para qué copiar y pegar nombres entre sistemas si una sola llamada API lo hace todo?

    Incorpore verificación de empresas, mapeo de propiedad, comprobación PEP, medios adversos y señales de sanciones directamente en sus flujos de trabajo existentes.

    §01The request

    p. 01 / 09

    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 "full_search"
    POST /v1/screen
    bash
    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": "full_search"
    8 }'

    §02The response

    p. 02 / 09
    POST /api/v1/screen — response
    200 OK
    1{
    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

    Structured JSON. Every risk vector.

    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

    §03API reference

    p. 03 / 09

    Three endpoints cover all screening workflows.

    API reference — endpoints
    v1 · rest
    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": "full_search"}'

    Response

    200 OK
    { "request_id": "srv_a8f3c1d9", "status": "queued",
    "estimated_seconds": 30, "poll_url": "/v1/result/srv_a8f3c1d9" }

    §04Integration patterns

    p. 04 / 09

    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

    §05Construirlo en casa frente a integrar ScreenVeritAI

    p. 05 / 09
    Tiempo hasta producción
    Construirlo en casa
    6-12 meses para conseguir listas, construir la coincidencia y cubrir casos límite
    API de ScreenVeritAI
    Días para integrar — listo para producción desde la primera llamada
    Cobertura de listas de sanciones
    Construirlo en casa
    Incorporación manual de cada formato de lista; mantenimiento continuo del esquema
    API de ScreenVeritAI
    Todas las fuentes principales mantenidas y actualizadas de forma continua
    Precisión de la coincidencia
    Construirlo en casa
    La coincidencia difusa a medida exige experiencia en PLN y ajuste constante
    API de ScreenVeritAI
    IA con coincidencia difusa, transliteración, resolución de alias y algoritmos fonéticos
    PEP y medios adversos
    Construirlo en casa
    Proveedores separados, integraciones separadas, presupuestos separados
    API de ScreenVeritAI
    Datos de PEP, medios adversos y UBO en la misma respuesta de la API
    Mantenimiento continuo
    Construirlo en casa
    Un equipo dedicado a actualizar listas, cambiar esquemas y ajustar falsos positivos
    API de ScreenVeritAI
    Gestionado por completo — actualizaciones, mejoras e infraestructura de nuestra cuenta
    Pista de auditoría
    Construirlo en casa
    Construya su propia infraestructura de registro, evidencia y conservación
    API de ScreenVeritAI
    Dosieres de evidencia con fecha y hora, con referencias de fuente incluidas

    §06Cuatro pasos hacia el cumplimiento integrado

    p. 06 / 09
    1

    Obtenga su clave de API

    Cree una clave con alcance limitado desde su panel, con permisos de mínimo privilegio: search:read, search:write, batch:read, batch:write.

    2

    Integre el endpoint

    Una sola llamada POST en su flujo de incorporación, pagos o CRM — envíe el nombre de la entidad, el tipo y el país, y reciba un ID de trabajo.

    3

    Procese los resultados

    Consulte el endpoint de resultados o reciba un aviso por webhook con JSON estructurado — contexto de la empresa, propiedad, PEP, medios adversos, señales de sanciones y puntuaciones de riesgo.

    4

    Monitorice y reciba alertas

    Configure la monitorización continua — la API envía alertas cuando se actualizan las listas de sanciones o aparecen nuevos medios adversos.

    §07Empiece en minutos

    p. 07 / 09

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

    Cribar una entidad
    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 el resultado
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08Rendimiento de la API

    p. 08 / 09

    Todas

    Fuentes principales verificadas por llamada a la API

    <2 min

    Tiempo de respuesta medio para un cribado completo con investigación profunda

    99.9%

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

    §09Preguntas frecuentes sobre la integración por API

    p. 09 / 09
    01¿Cómo autentico las solicitudes a la API?
    Autentique las solicitudes a la API con una clave secreta en la cabecera Authorization. Las claves se crean desde su panel con permisos limitados y de mínimo privilegio.
    02¿La API es síncrona o asíncrona?
    Asíncrona. Envíe una solicitud, reciba un ID de trabajo, recupere los resultados mediante sondeo o webhook. Su canalización nunca se bloquea.
    03¿Qué formato de respuesta devuelve la API?
    JSON estructurado con coincidencias de sanciones, alertas PEP, medios adversos, puntuaciones de confianza, referencias de fuente y clasificación de nivel de riesgo.
    04¿Qué límites de solicitudes se aplican?
    Se asignan según el nivel de suscripción por clave de API. Las cabeceras de respuesta incluyen la cuota restante y la hora de reinicio.
    05¿Puedo cribar entidades por lotes mediante la API?
    Sí. El endpoint de lotes acepta CSV o XLSX con hasta 100 filas por solicitud, y los resultados se pueden recuperar por fila o como una exportación completa.
    06¿Cómo configuro la monitorización continua mediante la API?
    Configure la monitorización tras el cribado inicial. Cuando se actualicen las listas o surjan nuevos medios adversos, la API envía un webhook a su endpoint.
    07¿Qué datos de cumplimiento incluye cada resultado de cribado?
    Coincidencias de sanciones en todas las fuentes principales, estatus PEP con conexiones familiares, medios adversos con citas multilingües, datos UBO, nivel de riesgo y un dosier de evidencia con fecha y hora.
    08¿Cuánto tarda un cribado?
    Una comprobación de sanciones estándar: segundos. Una investigación profunda con medios adversos y mapeo de propiedad: menos de dos minutos.
    Terminología de la API
    API REST
    API web que usa métodos HTTP estándar — compatible con cualquier lenguaje o framework capaz de hacer solicitudes HTTP.
    Webhook
    Aviso HTTP de servidor a servidor que se dispara cuando termina un cribado o la monitorización detecta un cambio.
    Procesamiento asíncrono
    La API acepta un trabajo de inmediato y lo procesa en segundo plano — recupere los resultados mediante sondeo o webhook.
    Clave de API
    Token secreto para autenticar las solicitudes a la API, con alcance limitado a permisos concretos de mínimo privilegio.
    Limitación de solicitudes
    Restringe el número de solicitudes a la API por ventana de tiempo según el nivel de suscripción — la cuota restante y la hora de reinicio van en las cabeceras de respuesta.
    Respuesta estructurada
    JSON legible por máquina con nombres y tipos de campo consistentes, que permite el análisis automatizado y la lógica de decisión.
    Fuentes del sector
    1. 01
    2. 02
      Tecnología regulatoria para el cumplimiento PBC/FT

      Banco de Pagos Internacionales — FSI Insights

    3. 03
      Marco de compromisos de cumplimiento de la OFAC

      Departamento del Tesoro de EE. UU.

    4. 04
    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    Empiece a verificar en minutos.

    Elija un plan y empiece a verificar hoy mismo.