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.

    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

    Construir 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

    Quatro 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 para obter 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.

    Comece em minutos

    p. 07 / 09

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

    Analisar uma entidade
    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 }
    Verificar 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 }

    Desempenho da API

    p. 08 / 09

    €0.39

    Quick Check por chamada, sem taxa de plataforma

    202

    Estado HTTP quando uma pesquisa é aceite; o resultado é depois consultado

    EU

    Alojado na Finlândia; os dados em repouso ficam na UE

    FAQ 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 X-API-Key. 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. 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 monitorização sinaliza a alteração e alerta-o na aplicação.
    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.
    Processamento assíncrono
    A API aceita a tarefa de imediato e processa-a em segundo plano — obtenha os resultados por polling.
    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.