ScreenVeritAI · API Specv1 · GA · reference
    Developer API

    Porquê copiar e colar nomes entre sistemas quando uma chamada de API faz tudo?

    Incorpore verificação de empresas, mapeamento de propriedade, verificação PEP, notícias adversas e sinais de sanções diretamente nos seus fluxos de trabalho 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

    §05Construir internamente vs. integrar a ScreenVeritAI

    p. 05 / 09
    Tempo até à produção
    Construir internamente
    6-12 meses para reunir listas, construir a correspondência e tratar casos-limite
    API ScreenVeritAI
    Dias para integrar — pronto para produção desde a primeira chamada de API
    Cobertura de listas de sanções
    Construir internamente
    Ingestão manual de cada formato de lista; manutenção contínua de esquemas
    API ScreenVeritAI
    Todas as principais fontes, mantidas e atualizadas continuamente
    Precisão de correspondência
    Construir internamente
    A correspondência aproximada personalizada exige conhecimento de PLN e afinação constante
    API ScreenVeritAI
    IA com correspondência aproximada, transliteração, resolução de aliases, algoritmos fonéticos
    PEP e notícias adversas
    Construir internamente
    Fornecedores separados, integrações separadas, orçamentos separados
    API ScreenVeritAI
    Dados de PEP, notícias adversas e UBO na mesma resposta de API
    Manutenção contínua
    Construir internamente
    Equipa dedicada para atualizações de listas, alterações de esquema, afinação de falsos positivos
    API ScreenVeritAI
    Totalmente gerido — atualizações, melhorias e infraestrutura tratadas por nós
    Registo de auditoria
    Construir internamente
    Construa a sua própria infraestrutura de registos, evidência e retenção
    API ScreenVeritAI
    Dossiês de evidência datados, com referências de fontes incluídas

    §06Quatro passos para compliance incorporado

    p. 06 / 09
    1

    Obtenha a sua chave de API

    Crie uma chave delimitada no seu painel, com permissões de privilégio mínimo: search:read, search:write, batch:read, batch:write.

    2

    Integre o endpoint

    Uma chamada POST no seu fluxo de onboarding, pagamentos ou CRM — envie o nome, tipo e país da entidade, e receba um ID de tarefa.

    3

    Processe os resultados

    Consulte o endpoint de resultados por polling, ou receba um callback por webhook com JSON estruturado — contexto da empresa, propriedade, PEP, notícias adversas, sinais de sanções e pontuações de risco.

    4

    Monitorize e alerte

    Configure a monitorização contínua — a API envia alertas quando as listas de sanções são atualizadas ou surgem novas notícias adversas.

    §07Comece em minutos

    p. 07 / 09

    Uma única chamada de API devolve um resultado de triagem completo.

    Analisar uma entidade
    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"}'
    Verificar resultado
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08Desempenho da API

    p. 08 / 09

    Todas

    Principais fontes analisadas por chamada de API

    <2 min

    Tempo médio de resposta para uma triagem completa com deep research

    99,9%

    SLA de disponibilidade da API para integrações de produção

    §09FAQ de integração de API

    p. 09 / 09
    01Como autentico os pedidos de API?
    Autentique os pedidos de API com uma chave secreta transmitida no cabeçalho Authorization. As chaves são criadas a partir do seu painel, com permissões delimitadas e de privilégio mínimo.
    02A API é síncrona ou assíncrona?
    Assíncrona. Submeta um pedido, receba um ID de tarefa, obtenha os resultados por polling ou webhook. O seu pipeline nunca bloqueia.
    03Que formato de resposta devolve a API?
    JSON estruturado, com correspondências de sanções, sinalizações PEP, notícias adversas, pontuações de confiança, referências de fontes e classificação por nível de risco.
    04Que limites de taxa se aplicam?
    Atribuídos por plano de subscrição, por chave de API. Os cabeçalhos de resposta incluem a quota restante e o carimbo de reposição.
    05Posso analisar entidades em lote através da API?
    Sim. O endpoint de lote aceita CSV ou XLSX com até 100 linhas por pedido, com resultados disponíveis por linha ou como uma exportação completa.
    06Como configuro a monitorização contínua via API?
    Configure a monitorização depois da triagem inicial. Quando as listas são atualizadas ou surgem novas notícias adversas, a API envia um webhook para o seu endpoint.
    07Que dados de compliance estão incluídos em cada resultado de triagem?
    Correspondências de sanções em todas as principais fontes, estatuto PEP com ligações familiares, notícias adversas com citações multilingues, dados UBO, nível de risco e dossiê de evidência datado.
    08Quanto tempo demora uma triagem?
    Verificação de sanções padrão: segundos. Deep research com notícias adversas e mapeamento de propriedade: menos de dois minutos.
    Terminologia da API
    API REST
    API web que utiliza métodos HTTP padrão — compatível com qualquer linguagem ou framework capaz de fazer pedidos HTTP.
    Webhook
    Callback HTTP servidor-a-servidor, acionado quando uma triagem termina ou a monitorização deteta uma alteração.
    Processamento assíncrono
    A API aceita uma tarefa de imediato e processa-a em segundo plano — obtenha os resultados por polling ou webhook.
    Chave de API
    Token secreto para autenticar pedidos de API, delimitado com permissões específicas para acesso de privilégio mínimo.
    Limite de taxa
    Restringe os pedidos de API por janela de tempo, consoante o plano de subscrição — a quota restante e os carimbos de reposição constam dos cabeçalhos de resposta.
    Resposta estruturada
    JSON legível por máquina, com nomes e tipos de campo consistentes, permitindo análise automatizada e lógica de decisão.
    Fontes do setor
    1. 01
    2. 02
      Regulatory Technology for AML/CFT Compliance

      Bank for International Settlements — FSI Insights

    3. 03
      OFAC Compliance Commitments Framework

      U.S. Department of the Treasury

    4. 04
      EU Anti-Money Laundering Authority (AMLA) Regulation

      Official Journal of the European Union

    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    Comece a triar em minutos.

    Escolha um plano e comece a triar hoje.