ScreenVeritAI · API Specv1 · GA · reference
개발자 API
시스템 간에 이름을 일일이 복사해 붙일 이유가 있을까요? API 호출 한 번이면 끝납니다.
기업 검증, 소유 구조 매핑, PEP 확인, 부정적 미디어, 제재 신호를 기존 워크플로에 직접 내장하십시오.
§01The request
p. 01 / 09One 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-awarecountryISO 3166-1 alpha-2 country codeprofile"sanctions_check" or "full_search"POST /v1/screen
bash1curl -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 / 09POST /api/v1/screen — response
200 OK1{
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 / 09Three endpoints cover all screening workflows.
API reference — endpoints
v1 · restPOST
/v1/screenSubmit 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 / 09The 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자체 구축 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
- 출처 참조가 포함된 타임스탬프 증거 번들 기본 제공
항목
자체 구축
ScreenVeritAI API
프로덕션까지 걸리는 시간
리스트 소싱, 매칭 구축, 예외 처리에 6~12개월
연동에 며칠 — 첫 API 호출부터 프로덕션 준비 완료
제재 리스트 커버리지
각 리스트 형식을 수작업으로 수집, 지속적인 스키마 유지보수 필요
모든 주요 소스를 지속적으로 유지·갱신
매칭 정확도
자체 퍼지 매칭에는 NLP 전문성과 지속적인 튜닝이 필요
퍼지 매칭, 음역, 별칭 해석, 음성 알고리즘을 갖춘 AI
PEP 및 부정적 미디어
별도 벤더, 별도 연동, 별도 예산
동일한 API 응답에 PEP, 부정적 미디어, 실제소유자 데이터 포함
지속적 유지보수
리스트 갱신, 스키마 변경, 오탐 튜닝을 위한 전담 팀 필요
완전 관리형 — 갱신, 개선, 인프라를 대신 처리합니다
감사 추적
로깅, 증거, 보존 인프라를 직접 구축
출처 참조가 포함된 타임스탬프 증거 번들 기본 제공
§06내장형 컴플라이언스로 가는 4단계
p. 06 / 091
API 키 발급받기
search:read, search:write, batch:read, batch:write 등 최소 권한으로 범위가 지정된 키를 대시보드에서 생성하십시오.
2
엔드포인트 연동
온보딩, 결제, CRM 워크플로에 POST 호출 한 번으로 대상명, 유형, 국가를 전송하고 작업 ID를 받으십시오.
3
결과 처리
결과 엔드포인트를 폴링하거나 웹훅 콜백으로 기업 맥락, 소유 구조, PEP, 부정적 미디어, 제재 신호, 리스크 점수가 담긴 구조화된 JSON을 받으십시오.
4
모니터링 및 알림
지속적 모니터링을 설정하십시오 — 제재 리스트가 갱신되거나 새로운 부정적 미디어가 드러나면 API가 알림을 전송합니다.
§07몇 분 만에 시작하기
p. 07 / 09API 호출 한 번으로 완전한 스크리닝 결과를 반환합니다.
대상 스크리닝
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'
§08API 성능
p. 08 / 09전체
API 호출당 스크리닝되는 주요 소스
2분 미만
심층 조사를 포함한 전체 스크리닝의 평균 응답 시간
99.9%
프로덕션 연동을 위한 API 가동 시간 SLA
§09API 연동 FAQ
p. 09 / 0901API 요청은 어떻게 인증합니까?
Authorization 헤더로 전달하는 비밀 키로 API 요청을 인증합니다. 키는 대시보드에서 최소 권한 원칙에 따라 범위가 제한된 권한으로 생성됩니다.
02API는 동기식입니까, 비동기식입니까?
비동기식입니다. 요청을 제출하면 작업 ID를 받고, 폴링이나 웹훅으로 결과를 조회합니다. 파이프라인이 막히는 일이 없습니다.
03API는 어떤 응답 형식을 반환합니까?
제재 매칭, PEP 플래그, 부정적 미디어, 신뢰도 점수, 출처 참조, 리스크 등급 분류가 담긴 구조화된 JSON입니다.
04어떤 속도 제한이 적용됩니까?
API 키별로 구독 등급에 따라 배정됩니다. 응답 헤더에 잔여 할당량과 초기화 시각이 포함됩니다.
05API로 대상을 일괄 스크리닝할 수 있습니까?
네. 일괄 엔드포인트는 요청당 최대 100행의 CSV 또는 XLSX를 받으며, 결과는 행 단위 또는 전체 내보내기로 조회할 수 있습니다.
06API로 지속적 모니터링을 어떻게 설정합니까?
최초 스크리닝 이후 모니터링을 설정하십시오. 리스트가 갱신되거나 새로운 부정적 미디어가 드러나면 API가 지정된 엔드포인트로 웹훅을 전송합니다.
07각 스크리닝 결과에는 어떤 컴플라이언스 데이터가 포함됩니까?
모든 주요 소스에 대한 제재 매칭, 가족 관계가 포함된 PEP 상태, 다국어 인용이 포함된 부정적 미디어, 실제소유자 데이터, 리스크 등급, 타임스탬프 증거 번들이 포함됩니다.
08스크리닝에는 얼마나 걸립니까?
표준 제재 점검은 몇 초이며, 부정적 미디어와 소유 구조 매핑을 포함한 심층 조사는 2분 미만입니다.
API 용어
업계 출처
- 01디지털 신원 및 고객실사에 관한 FATF 가이드
국제자금세탁방지기구(FATF)
- 02AML/CFT 컴플라이언스를 위한 레그테크
국제결제은행 — FSI Insights
- 03OFAC 컴플라이언스 서약 프레임워크
미국 재무부
- 04EU 자금세탁방지기구(AMLA) 규정
유럽연합 관보
더 알아보기
chk api-v1svai-api-specv1 · ga2 samples · reference
End of API specification.