ScreenVeritAI · API Specv1 · GA · reference
    Developer API

    Зачем копировать имена между системами вручную, если один вызов API делает всё сам?

    Встройте верификацию компаний, картирование владения, проверку ПДЛ, негативные публикации и санкционные сигналы прямо в существующие рабочие процессы.

    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

    Разработка своими силами vs. интеграция ScreenVeritAI

    p. 05 / 09
    Время до запуска в продакшене
    Разработка своими силами
    6–12 месяцев на поиск списков, разработку сопоставления, обработку крайних случаев
    API ScreenVeritAI
    Дни на интеграцию — готово к продакшену с первого вызова API
    Охват санкционных списков
    Разработка своими силами
    Ручной приём каждого формата списка; постоянное обслуживание схем
    API ScreenVeritAI
    Каждый основной источник, поддерживаемый и непрерывно обновляемый
    Точность сопоставления
    Разработка своими силами
    Собственное нечёткое сопоставление требует экспертизы в NLP и постоянной настройки
    API ScreenVeritAI
    ИИ с нечётким сопоставлением, транслитерацией, разрешением псевдонимов, фонетическими алгоритмами
    ПДЛ и негативные публикации
    Разработка своими силами
    Отдельные поставщики, отдельные интеграции, отдельные бюджеты
    API ScreenVeritAI
    Данные по ПДЛ, негативным публикациям и UBO в одном ответе API
    Постоянное обслуживание
    Разработка своими силами
    Выделенная команда для обновления списков, изменений схем, настройки ложных срабатываний
    API ScreenVeritAI
    Полностью управляемый сервис — обновления, улучшения и инфраструктура на нашей стороне
    Аудиторский след
    Разработка своими силами
    Собственная разработка логирования, доказательств и инфраструктуры хранения
    API ScreenVeritAI
    Пакеты доказательств с временными метками и ссылками на источники включены

    Четыре шага к встроенному комплаенсу

    p. 06 / 09
    1

    Получите свой API-ключ

    Создайте ключ с ограниченными правами в панели управления по принципу наименьших привилегий: search:read, search:write, batch:read, batch:write.

    2

    Интегрируйте эндпоинт

    Один вызов POST в ваш процесс онбординга, платежей или CRM — отправьте имя, тип и страну субъекта, получите идентификатор задания.

    3

    Обработайте результаты

    Опрашивайте эндпоинт результатов для получения структурированного JSON — контекст компании, владение, ПДЛ, негативные публикации, санкционные сигналы и оценки риска.

    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 с помощью секретного ключа, передаваемого в заголовке X-API-Key. Ключи создаются в панели управления с ограниченными, минимально необходимыми правами доступа.
    02API синхронный или асинхронный?
    Асинхронный. Отправьте запрос, получите идентификатор задания, забирайте результаты через опрос статуса. Ваш конвейер никогда не блокируется.
    03В каком формате API возвращает ответ?
    Структурированный JSON с санкционными совпадениями, флагами ПДЛ, негативными публикациями, показателями достоверности, ссылками на источники и классификацией по уровню риска.
    04Какие лимиты запросов применяются?
    Назначаются по тарифу подписки для каждого API-ключа. Заголовки ответа содержат оставшуюся квоту и время сброса.
    05Можно ли проверять субъекты пакетно через API?
    Да. Эндпоинт пакетной обработки принимает CSV или XLSX до 100 строк за запрос, результаты доступны построчно или в виде полного экспорта.
    06Как настроить непрерывный мониторинг через API?
    Настройте мониторинг после первичного скрининга. При обновлении списков или появлении новых негативных публикаций мониторинг помечает изменение и уведомляет вас в приложении.
    07Какие комплаенс-данные включены в каждый результат скрининга?
    Санкционные совпадения по каждому основному источнику, статус ПДЛ со связями в семье, негативные публикации с многоязычными цитатами, данные UBO, уровень риска и пакет доказательств с временными метками.
    08Сколько времени занимает скрининг?
    Стандартная проверка по санкциям: секунды. Глубокое исследование с негативными публикациями и картированием владения: менее двух минут.
    Терминология API
    REST API
    Веб-API на основе стандартных методов HTTP — совместим с любым языком или фреймворком, способным выполнять HTTP-запросы.
    Асинхронная обработка
    API сразу принимает задание и обрабатывает его в фоне — результаты получайте через опрос статуса.
    API-ключ
    Секретный токен для аутентификации запросов к API с ограниченными правами для доступа по принципу наименьших привилегий.
    Ограничение частоты запросов
    Ограничивает количество запросов к API за временное окно по тарифу подписки — оставшаяся квота и время сброса указаны в заголовках ответа.
    Структурированный ответ
    Машиночитаемый JSON с согласованными именами и типами полей, обеспечивающий автоматический разбор и логику принятия решений.
    Отраслевые источники
    1. 01
      Руководство FATF по цифровой идентификации и надлежащей проверке клиентов

      Группа разработки финансовых мер борьбы с отмыванием денег (FATF)

    2. 02
      Регуляторные технологии для комплаенса ПОД/ФТ

      Банк международных расчётов — FSI Insights

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

    End of API specification.

    Начните проверку за считанные минуты.

    Выберите тариф и начните проверку уже сегодня.