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

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

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

    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

    Собствена разработка срещу интеграция с 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
    Доказателствени пакети с времеви печат, референции към източници и обосновка на решението, включени

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

    p. 06 / 09
    1

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

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

    2

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

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

    3

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

    Запитвайте крайната точка за резултати за структуриран JSON — фирмен контекст, собственост, PEP, негативни медии, санкционни сигнали и рискови оценки.

    4

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

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

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

    p. 07 / 09

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

    Проверете субект
    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 }
    Проверете резултат
    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 }

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

    p. 08 / 09

    €0.39

    Quick Check на заявка, без такса за платформа

    202

    HTTP статус при приета проверка; резултатът се изтегля след това

    EU

    Хостван във Финландия; данните в покой остават в ЕС

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

    p. 09 / 09
    01Как се удостоверяват API заявките?
    Всички API заявки се удостоверяват с API ключ, предаден в заглавието X-API-Key. Ключовете се създават от таблото за управление на ScreenVeritAI с ограничени разрешения (search:read, search:write, batch:read, batch:write) за налагане на достъп с минимални привилегии.
    02API-то синхронно ли е или асинхронно?
    Асинхронен. Изпращате заявка, получавате ID на задача и извличате резултатите чрез периодично запитване. Вашият процес никога не блокира.
    03Какъв формат на отговор връща API-то?
    Всички отговори са структуриран JSON с последователни имена на полета и типове. Резултатите от скрининга включват детайли за санкционни съвпадения, PEP маркировки, констатации за негативни медии, оценки за достоверност, референции към източници и рисково ниво — готови за автоматизирано парсване и логика за вземане на решения без ръчно извличане.
    04Какви ограничения на честотата се прилагат?
    Ограниченията на честотата се задават по ниво на абонамент и се налагат за всеки API ключ. Заглавките на отговорите включват текущото ви ограничение, оставаща квота и времеви печат за нулиране. Ако ви е необходима по-висока пропускателна способност за масова обработка, крайната точка за партиди приема CSV/XLSX качвания за скрининг с висок обем.
    05Мога ли да проверявам субекти пакетно чрез API-то?
    Да. Крайната точка за партиди приема CSV или XLSX файлове с до 100 реда на заявка. Всеки ред се обработва като индивидуален скрининг и резултатите могат да бъдат извлечени по ред или като пълен изтегляем експорт, когато задачата приключи.
    06Как да настроя текущ мониторинг чрез API-то?
    Конфигурирайте мониторинга след първоначалния скрининг. Когато списъците се актуализират или се появят нови негативни медии, мониторингът отбелязва промяната и ви уведомява в приложението.
    07Какви данни за съответствие са включени във всеки резултат от скрининг?
    Всеки резултат включва санкционни съвпадения от всеки основен източник, PEP статус с връзки към семейство и сътрудници, констатации за негативни медии с многоезични цитирани източници, данни за собственост на КДС, рисково ниво и доказателствен пакет с времеви печат, подходящ за одит и регулаторен преглед.
    08Колко време отнема скринингът?
    Стандартна проверка за санкции обикновено приключва за секунди. Скрининг със задълбочено проучване — включващ анализ на негативни медии и картографиране на собствеността — отнема средно под две минути. Асинхронният модел означава, че системата ви никога не е блокирана в очакване на резултати.
    API терминология
    REST API
    Архитектура на уеб API, която използва стандартни HTTP методи (GET, POST, PUT, DELETE) за взаимодействие с ресурси. API-то на ScreenVeritAI следва REST конвенциите, което го прави съвместимо с всеки език или рамка, способни да правят HTTP заявки.
    Асинхронна обработка
    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.

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

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