# API за разработчици

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

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

Вземете API ключ Вижте цените

// The request

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 "deep_research"

POST /v1/screenbash

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": "deep_research"

8 }'

POST /api/v1/screen — response200 OK

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

// The response

Structured JSON. Every risk vector. Color-coded.

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

// Endpoints

API Reference

Three endpoints cover all screening workflows.

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": "deep_research"}'

Response

200 OK

{ "request_id": "srv_a8f3c1d9", "status": "queued",

"estimated_seconds": 30, "poll_url": "/v1/result/srv_a8f3c1d9" }

// Integration patterns

Drop into your existing workflow

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

// Build vs buy

Собствена разработка срещу покупка

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

// How it works

Четири стъпки до продукция

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

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

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

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

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

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

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

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

// Quickstart examples

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

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

Проверете субектbash

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

bash

curl https://api.screenveritai.com/v1/results/RESULT_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

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

10+

Глобални санкционни режима, проверявани при всяко API извикване

<2 min

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

99.9%

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

// FAQ

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

#Как се удостоверяват API заявките?

Всички API заявки се удостоверяват с API ключ, предаден в заглавието Authorization. Ключовете се създават от таблото за управление на ScreenVeritAI с ограничени разрешения (search:read, search:write, batch:read, batch:write) за налагане на достъп с минимални привилегии.

#API-то синхронно ли е или асинхронно?

API-то използва модел на асинхронна обработка. Подавате заявка за скрининг чрез POST и получавате идентификатор на задачата незабавно. Резултатите се извличат чрез анкетиране на крайната точка за резултати или чрез конфигуриране на обратно извикване чрез уебхук. Това предотвратява блокирането в продукционния ви тръбопровод, докато AI агентът завършва анализа си.

#Какъв формат на отговор връща API-то?

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

#Какви ограничения на честотата се прилагат?

Ограниченията на честотата се задават по ниво на абонамент и се налагат за всеки API ключ. Заглавките на отговорите включват текущото ви ограничение, оставаща квота и времеви печат за нулиране. Ако ви е необходима по-висока пропускателна способност за масова обработка, крайната точка за партиди приема CSV/XLSX качвания за скрининг с висок обем.

#Мога ли да проверявам субекти пакетно чрез API-то?

Да. Крайната точка за партиди приема CSV или XLSX файлове с до 100 реда на заявка. Всеки ред се обработва като индивидуален скрининг и резултатите могат да бъдат извлечени по ред или като пълен изтегляем експорт, когато задачата приключи.

#Как да настроя текущ мониторинг чрез API-то?

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

#Какви данни за съответствие са включени във всеки резултат от скрининг?

Всеки резултат включва санкционни съвпадения от 10+ режима, PEP статус с връзки към семейство и сътрудници, констатации за негативни медии с многоезични цитирани източници, данни за собственост на КДС, рисково ниво и доказателствен пакет с времеви печат, подходящ за одит и регулаторен преглед.

#Колко време отнема скринингът?

Стандартна проверка за санкции обикновено приключва за секунди. Скрининг със задълбочено проучване — включващ анализ на негативни медии и картографиране на собствеността — отнема средно под две минути. Асинхронният модел означава, че системата ви никога не е блокирана в очакване на резултати.

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]
Ръководство на FATF за цифрова идентичност и надлежна проверка на клиента
Група за финансово действие (FATF)
[2]
Регулаторни технологии за AML/CFT съответствие
Банка за международни разплащания — FSI Insights
[3]
Рамка на OFAC за ангажименти за съответствие
Министерство на финансите на САЩ
[4]
Регламент на ЕС за Органа за борба с изпирането на пари (AMLA)
Официален вестник на Европейския съюз

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

One POST call. That's your entire integration.

Structured JSON. Every risk vector. Color-coded.

API Reference

Drop into your existing workflow

Собствена разработка срещу покупка

Четири стъпки до продукция

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

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

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

API терминология

/* Индустриални източници */

// Разгледайте още

Санкционен скрининг

Скрининг на клиенти и надлежна проверка

Пакетен скрининг

Покритие на санкционни списъци

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