ScreenVeritAI
    ScreenVeritAI · API Specv1 · GA · reference
    개발자 API

    시스템 간에 이름을 일일이 복사해 붙일 이유가 있을까요? API 호출 한 번이면 끝납니다.

    기업 검증, 소유 구조 매핑, PEP 확인, 부정적 미디어, 제재 신호를 기존 워크플로에 직접 내장하십시오.

    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개월
    ScreenVeritAI API
    연동에 며칠 — 첫 API 호출부터 프로덕션 준비 완료
    제재 리스트 커버리지
    자체 구축
    각 리스트 형식을 수작업으로 수집, 지속적인 스키마 유지보수 필요
    ScreenVeritAI API
    모든 주요 소스를 지속적으로 유지·갱신
    매칭 정확도
    자체 구축
    자체 퍼지 매칭에는 NLP 전문성과 지속적인 튜닝이 필요
    ScreenVeritAI API
    퍼지 매칭, 음역, 별칭 해석, 음성 알고리즘을 갖춘 AI
    PEP 및 부정적 미디어
    자체 구축
    별도 벤더, 별도 연동, 별도 예산
    ScreenVeritAI API
    동일한 API 응답에 PEP, 부정적 미디어, 실제소유자 데이터 포함
    지속적 유지보수
    자체 구축
    리스트 갱신, 스키마 변경, 오탐 튜닝을 위한 전담 팀 필요
    ScreenVeritAI API
    완전 관리형 — 갱신, 개선, 인프라를 대신 처리합니다
    감사 추적
    자체 구축
    로깅, 증거, 보존 인프라를 직접 구축
    ScreenVeritAI API
    출처 참조가 포함된 타임스탬프 증거 번들 기본 제공

    내장형 컴플라이언스로 가는 4단계

    p. 06 / 09
    1

    API 키 발급받기

    search:read, search:write, batch:read, batch:write 등 최소 권한으로 범위가 지정된 키를 대시보드에서 생성하십시오.

    2

    엔드포인트 연동

    온보딩, 결제, CRM 워크플로에 POST 호출 한 번으로 대상명, 유형, 국가를 전송하고 작업 ID를 받으십시오.

    3

    결과 처리

    결과 엔드포인트를 폴링해 기업 맥락, 소유 구조, PEP, 부정적 미디어, 제재 신호, 리스크 점수가 담긴 구조화된 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 1회 호출당, 플랫폼 요금 없음

    202

    검색이 접수될 때의 HTTP 상태. 이후 결과를 폴링으로 조회

    EU

    핀란드에서 호스팅. 저장 데이터는 EU 내에 유지

    API 연동 FAQ

    p. 09 / 09
    01API 요청은 어떻게 인증합니까?
    X-API-Key 헤더로 전달하는 비밀 키로 API 요청을 인증합니다. 키는 대시보드에서 최소 권한 원칙에 따라 범위가 제한된 권한으로 생성됩니다.
    02API는 동기식입니까, 비동기식입니까?
    비동기식입니다. 요청을 제출하면 작업 ID를 받고, 결과는 폴링으로 조회합니다. 파이프라인이 막히는 일이 없습니다.
    03API는 어떤 응답 형식을 반환합니까?
    제재 매칭, PEP 플래그, 부정적 미디어, 신뢰도 점수, 출처 참조, 리스크 등급 분류가 담긴 구조화된 JSON입니다.
    04어떤 속도 제한이 적용됩니까?
    API 키별로 구독 등급에 따라 배정됩니다. 응답 헤더에 잔여 할당량과 초기화 시각이 포함됩니다.
    05API로 대상을 일괄 스크리닝할 수 있습니까?
    네. 일괄 엔드포인트는 요청당 최대 100행의 CSV 또는 XLSX를 받으며, 결과는 행 단위 또는 전체 내보내기로 조회할 수 있습니다.
    06API로 지속적 모니터링을 어떻게 설정합니까?
    최초 스크리닝 이후 모니터링을 설정하십시오. 리스트가 갱신되거나 새로운 부정적 미디어가 드러나면 모니터링이 변경을 표시하고 앱 내에서 알림을 보냅니다.
    07각 스크리닝 결과에는 어떤 컴플라이언스 데이터가 포함됩니까?
    모든 주요 소스에 대한 제재 매칭, 가족 관계가 포함된 PEP 상태, 다국어 인용이 포함된 부정적 미디어, 실제소유자 데이터, 리스크 등급, 타임스탬프 증거 번들이 포함됩니다.
    08스크리닝에는 얼마나 걸립니까?
    표준 제재 점검은 몇 초이며, 부정적 미디어와 소유 구조 매핑을 포함한 심층 조사는 2분 미만입니다.
    API 용어
    REST API
    표준 HTTP 메서드를 사용하는 웹 API로, HTTP 요청이 가능한 모든 언어나 프레임워크와 호환됩니다.
    비동기 처리
    API가 작업을 즉시 접수해 백그라운드에서 처리하며, 결과는 폴링으로 조회합니다.
    API 키
    API 요청을 인증하기 위한 비밀 토큰으로, 최소 권한 접근을 위해 특정 권한 범위가 지정됩니다.
    속도 제한
    구독 등급별로 시간 단위당 API 요청 수를 제한하며, 잔여 할당량과 초기화 시각은 응답 헤더에 포함됩니다.
    구조화된 응답
    일관된 필드명과 타입을 갖춘 기계 판독 가능한 JSON으로, 자동 파싱과 판단 로직을 가능하게 합니다.
    업계 출처
    1. 01
    2. 02
      AML/CFT 컴플라이언스를 위한 레그테크

      국제결제은행 — FSI Insights

    3. 03
    4. 04
    더 알아보기

    제재 스크리닝

    퍼지 매칭과 집행 등급 증거로 모든 주요 소스에 대해 대상을 스크리닝하십시오.

    고객 스크리닝 및 실사

    소유 구조, PEP 노출, 부정적 미디어, 제재 신호를 매핑해 전체 거래상대방 리스크 프로필을 확보하십시오.

    일괄 스크리닝

    CSV 또는 XLSX 파일을 업로드해 수백 명의 고객, 공급업체, 벤더를 하나의 작업으로 검증하십시오.

    제재 리스트 커버리지

    ScreenVeritAI가 포괄하는 모든 제재 리스트, PEP 데이터베이스, 관할권을 확인하십시오.

    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    몇 분 만에 심사를 시작하십시오.

    요금제를 선택하고 오늘 바로 심사를 시작하십시오.

    요금제 보기