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.

    The request

    p. 01 / 09

    One POST call, then your poll loop.

    Entity name, type, country, screening type. The call returns 202 with a search_id and an ETA, and the agent works in the background — you poll for the result rather than hold the connection open.

    entity_nameRequired, 1-500 characters. Alias-aware matching
    entity_type"person", "company" or "any" (default "any")
    countryOptional jurisdiction hint that sharpens identity resolution
    search_type"sanctions_check", "adverse_media" or "full_search"
    POST /api/v1/search
    bash
    1curl -X POST https://screenveritai.com/api/v1/search \
    2 -H 'X-API-Key: YOUR_API_KEY' \
    3 -H 'Content-Type: application/json' \
    4 -d '{
    5 "entity_name": "Acme Trading LLC",
    6 "entity_type": "company",
    7 "country": "AE",
    8 "search_type": "sanctions_check"
    9 }'
    10# 202 Accepted
    11# { "search_id": "SEARCH_ID", "status": "processing",
    12# "estimated_time_seconds": 15 }

    The response

    p. 02 / 09
    GET /api/v1/search/{search_id} — response
    200 OK
    1{
    2"id": "SEARCH_ID",
    3"entity_name": "Acme Trading LLC",
    4"entity_type": "company",
    5"status": "completed",
    6"search_type": "sanctions_check",
    7"ofac_sanctions": "## OFAC Sanctions Findings\n\n
    8**Status:** *Sanctioned*\n\n**Details:**\n
    9- **Matched entity:** ACME TRADING LLC\n
    10- **Authority:** US Treasury OFAC\n...",
    11"eu_sanctions": "## EU Sanctions Findings\n\n
    12**Status:** *No relevant listing found*\n...",
    13"sanctions_sources": [
    14{ "source_id": "ofac_sanctions", "title": "OFAC Sanctions",
    15"authority": "US Treasury OFAC", "hit_count": 1 },
    16{ "source_id": "eu_sanctions", "title": "EU Sanctions",
    17"authority": "", "hit_count": 0 }
    18],
    19"criminal_watchlists": null,
    20"pep": null,
    21"news_summary": null,
    22"final_report": null,
    23"created_at": "2026-09-04T09:20:03.771000+00:00",
    24"completed_at": "2026-09-04T09:20:19.088000+00:00"
    25}
    No relevant listing found / null
    Sanctioned / potential match
    Per-source hit_count
    Status and search_type

    Structured JSON. Findings, not a score.

    One field per sanctions source, plus criminal watchlists and PEP. Each finding is markdown carrying the status line, the matched entity, the authority and an evidence URL — there is no numeric score and no risk tier, because a number hides the line an auditor asks to see.

    "ofac_sanctions"One markdown field per jurisdiction; read the *Status:* line
    "sanctions_sources"source_id, title, authority, details, hit_count per source
    "criminal_watchlists"Markdown when matched, null when nothing matched
    "pep"Markdown when matched, null when nothing matched
    "news_summary"Adverse-media report on adverse_media and full_search
    "status"completed when done; error_* on failure

    API reference

    p. 03 / 09

    Three calls cover a screening integration: queue it, poll it, or hand over a file.

    API reference — endpoints
    v1 · rest
    POST
    /api/v1/search

    Queue a screening run. Returns immediately with a search_id; the work happens in the background.

    Request

    curl -X POST https://screenveritai.com/api/v1/search \
    -H 'X-API-Key: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{"entity_name": "Acme Trading LLC", "entity_type": "company",
    "country": "AE", "search_type": "sanctions_check"}'

    Response

    202 Accepted
    { "search_id": "SEARCH_ID", "status": "processing",
    "message": "Search queued successfully. Poll the GET endpoint for results.",
    "estimated_time_seconds": 15 }

    Integration patterns

    p. 04 / 09

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

    Customer onboarding
    Customer signupPOST /api/v1/searchPoll until completedApprove / hold
    Payment processing
    Transaction initPOST /api/v1/searchPoll until completedRelease / hold
    CRM re-screen
    Record updatedYour scheduler firesPOST /api/v1/searchWrite result back

    Construirlo 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

    Cuatro 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

    Sondee el endpoint de resultados para obtener 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.

    Empiece 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://screenveritai.com/api/v1/search \
      -H 'X-API-Key: YOUR_API_KEY' \
      -H 'Content-Type: application/json' \
      -d '{"entity_name": "Acme Trading LLC", "country": "AE", "search_type": "sanctions_check"}'
    
    # 202 Accepted
    # { "search_id": "SEARCH_ID", "status": "processing", "estimated_time_seconds": 15 }
    Consultar el resultado
    bash
    curl https://screenveritai.com/api/v1/search/SEARCH_ID \
      -H 'X-API-Key: YOUR_API_KEY'
    
    # 200 OK
    # { "id": "SEARCH_ID", "status": "completed",
    #   "ofac_sanctions": "## OFAC Sanctions Findings ... *No relevant listing found* ...",
    #   "criminal_watchlists": null, "pep": null }

    Rendimiento de la API

    p. 08 / 09

    €0.39

    Quick Check por llamada, sin cuota de plataforma

    202

    Estado HTTP cuando se acepta una búsqueda; después se consulta el resultado

    EU

    Alojado en Finlandia; los datos en reposo permanecen en la UE

    Preguntas 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 X-API-Key. 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, obtenga un ID de trabajo y recupere los resultados mediante sondeo. Su pipeline 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 monitorización señala el cambio y le avisa en la app.
    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.
    Procesamiento asíncrono
    La API acepta un trabajo de inmediato y lo procesa en segundo plano — recupere los resultados mediante sondeo.
    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.