ScreenVeritAI · API Specv1 · GA · reference
    API за разработчици

    Вградете скрининг за съответствие във всеки работен процес

    Вашият тръбопровод за приемане, платежен шлюз и CRM вече вземат рискови решения всеки ден. API на ScreenVeritAI ви позволява да вградите скрининг за санкции, PEP проверки, анализ на негативни медии и картографиране на КДС директно в тези работни процеси — без ръчни справки, без копиране и поставяне, без пропуски в съответствието между системите. Едно API извикване задейства същия AI агент, който захранва нашата платформа, и структуриран JSON се връща, готов за вашия двигател за вземане на решения.

    §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

    §05Собствена разработка срещу интеграция с ScreenVeritAI

    p. 05 / 09
    Време до продукция
    Собствена разработка
    6-12 месеца за набавяне на списъци, изграждане на логика за съвпадение и обработка на крайни случаи
    API на ScreenVeritAI
    Дни за интеграция; готово за продукция от първото API извикване
    Покритие на санкционни списъци
    Собствена разработка
    Ръчно приемане на всеки формат на списък; текуща поддръжка при промяна на схемите
    API на ScreenVeritAI
    Всеки основен източник, поддържан и актуализиран непрекъснато — OFAC, ЕС, ООН, Обединеното кралство и други
    Точност на съвпадение
    Собствена разработка
    Потребителско неточно съвпадение изисква NLP експертиза и непрекъсната настройка
    API на ScreenVeritAI
    AI агент с неточно съвпадение, транслитерация, разрешаване на псевдоними и фонетични алгоритми
    PEP и негативни медии
    Собствена разработка
    Отделни доставчици на данни, отделни интеграции, отделни бюджети
    API на ScreenVeritAI
    PEP, негативни медии и КДС данни, включени в същия API отговор
    Текуща поддръжка
    Собствена разработка
    Специализиран инженерен екип за актуализации на списъци, промени в схеми и настройка на фалшиви положителни
    API на ScreenVeritAI
    Изцяло управлявано — актуализации на списъци, подобрения на модели и инфраструктура се обработват вместо вас
    Одитна следа
    Собствена разработка
    Изграждане на собствена инфраструктура за логване, генериране на доказателства и съхранение
    API на ScreenVeritAI
    Доказателствени пакети с времеви печат, референции към източници и обосновка на решението, включени

    §06Четири стъпки до вградено съответствие

    p. 06 / 09
    1

    Вземете вашия API ключ

    Създайте API ключ с ограничени права от таблото за управление на ScreenVeritAI. Задайте разрешения — search:read, search:write, batch:read, batch:write — за достъп с минимални привилегии.

    2

    Интегрирайте крайната точка

    Добавете едно POST извикване към работния процес за приемане, плащане или CRM. Изпратете наименование на субекта, тип и държава. API-то връща идентификатор на задачата за асинхронно извличане на резултати.

    3

    Обработете резултатите

    Анкетирайте крайната точка за резултати или получете обратно извикване чрез уебхук. Парснете структурирания JSON отговор — санкционни съвпадения, PEP маркировки, констатации за негативни медии и рискови оценки — и насочете към логиката си за вземане на решения.

    4

    Мониторинг и известия

    Конфигурирайте текущ мониторинг за проверените субекти. Когато санкционните списъци се актуализират или се появят нови негативни медии, API-то изпраща известия, така че системата ви може автоматично да задейства повторен скрининг.

    §07Започнете за минути

    p. 07 / 09

    Едно API извикване връща пълен резултат от скрининг.

    Проверете субект
    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"}'
    Проверете резултат
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08Производителност на API-то

    p. 08 / 09

    Всички

    Основни източници, проверявани при всяко API извикване

    <2 min

    Средно време за отговор за пълен скрининг със задълбочено проучване

    99.9%

    SLA за наличност на API-то за продукционни интеграции

    §09Често задавани въпроси за API интеграция

    p. 09 / 09
    01Как се удостоверяват API заявките?
    Всички API заявки се удостоверяват с API ключ, предаден в заглавието Authorization. Ключовете се създават от таблото за управление на ScreenVeritAI с ограничени разрешения (search:read, search:write, batch:read, batch:write) за налагане на достъп с минимални привилегии.
    02API-то синхронно ли е или асинхронно?
    API-то използва модел на асинхронна обработка. Подавате заявка за скрининг чрез POST и получавате идентификатор на задачата незабавно. Резултатите се извличат чрез анкетиране на крайната точка за резултати или чрез конфигуриране на обратно извикване чрез уебхук. Това предотвратява блокирането в продукционния ви тръбопровод, докато AI агентът завършва анализа си.
    03Какъв формат на отговор връща API-то?
    Всички отговори са структуриран JSON с последователни имена на полета и типове. Резултатите от скрининга включват детайли за санкционни съвпадения, PEP маркировки, констатации за негативни медии, оценки за достоверност, референции към източници и рисково ниво — готови за автоматизирано парсване и логика за вземане на решения без ръчно извличане.
    04Какви ограничения на честотата се прилагат?
    Ограниченията на честотата се задават по ниво на абонамент и се налагат за всеки API ключ. Заглавките на отговорите включват текущото ви ограничение, оставаща квота и времеви печат за нулиране. Ако ви е необходима по-висока пропускателна способност за масова обработка, крайната точка за партиди приема CSV/XLSX качвания за скрининг с висок обем.
    05Мога ли да проверявам субекти пакетно чрез API-то?
    Да. Крайната точка за партиди приема CSV или XLSX файлове с до 100 реда на заявка. Всеки ред се обработва като индивидуален скрининг и резултатите могат да бъдат извлечени по ред или като пълен изтегляем експорт, когато задачата приключи.
    06Как да настроя текущ мониторинг чрез API-то?
    След първоначалния скрининг можете да конфигурирате мониторинг за проверения субект. Когато санкционните списъци се актуализират или се появят нови негативни медии, API-то изпраща известие чрез уебхук към конфигурираната ви крайна точка, за да може системата ви автоматично да задейства повторен скрининг или ескалация.
    07Какви данни за съответствие са включени във всеки резултат от скрининг?
    Всеки резултат включва санкционни съвпадения от всеки основен източник, PEP статус с връзки към семейство и сътрудници, констатации за негативни медии с многоезични цитирани източници, данни за собственост на КДС, рисково ниво и доказателствен пакет с времеви печат, подходящ за одит и регулаторен преглед.
    08Колко време отнема скринингът?
    Стандартна проверка за санкции обикновено приключва за секунди. Скрининг със задълбочено проучване — включващ анализ на негативни медии и картографиране на собствеността — отнема средно под две минути. Асинхронният модел означава, че системата ви никога не е блокирана в очакване на резултати.
    API терминология
    REST API
    Архитектура на уеб API, която използва стандартни HTTP методи (GET, POST, PUT, DELETE) за взаимодействие с ресурси. API-то на ScreenVeritAI следва REST конвенциите, което го прави съвместимо с всеки език или рамка, способни да правят HTTP заявки.
    Уебхук
    HTTP обратно извикване от сървър към сървър, задействано от събитие. Вместо да анкетирате за резултати, можете да конфигурирате ScreenVeritAI да изпрати POST заявка към вашата крайна точка, когато скринингът приключи или когато текущият мониторинг открие промяна.
    Асинхронна обработка
    Модел на заявка, при който API-то приема задача незабавно и я обработва на заден план. Клиентът получава идентификатор на задачата и извлича резултатите по-късно чрез анкетиране или уебхук. Този модел предотвратява блокирането в продукционни тръбопроводи.
    API ключ
    Секретен токен, използван за удостоверяване на API заявки от сървър към сървър. API ключовете на ScreenVeritAI са с ограничени разрешения (search:read, search:write, batch:read, batch:write) за налагане на модели за достъп с минимални привилегии.
    Ограничаване на честотата
    Механизъм, който ограничава броя API заявки, които клиентът може да направи в даден времеви прозорец. Ограниченията на честотата се задават по ниво на абонамент и се комуникират чрез заглавки на отговорите, включващи оставаща квота и времеви печати за нулиране.
    Структуриран отговор
    Машинночетим формат на API отговор (JSON) с последователни имена на полета, типове и вложеност. Структурираните отговори позволяват автоматизирано парсване, логика за вземане на решения и генериране на одитна следа без ръчно извличане на данни.
    Индустриални източници
    1. 01
    2. 02
      Регулаторни технологии за AML/CFT съответствие

      Банка за международни разплащания — FSI Insights

    3. 03
      Рамка на OFAC за ангажименти за съответствие

      Министерство на финансите на САЩ

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

    End of API specification.

    Започнете скрининг за минути.

    Изберете план и започнете скрининг още днес.