ScreenVeritAI · API Specv1 · GA · reference

API għall-Iżviluppaturi

Għaliex tikkopja u tinkolla ismijiet bejn is-sistemi meta sejħa waħda tal-API tagħmilhom kollha?

Daħħal verifika tal-kumpaniji, immappjar tas-sjieda, kontrolli PEP, midja avversa, u sinjali tas-sanzjonijiet direttament fil-flussi tax-xogħol eżistenti tiegħek.

Ikseb API key Ara l-ipprezzar

§01The request

p. 01 / 09

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

POST /v1/screen

bash

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

8 }'

§02The response

p. 02 / 09

POST /api/v1/screen — response

200 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

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 / 09

Three endpoints cover all screening workflows.

API reference — endpoints

v1 · rest

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

Response

200 OK

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

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

§04Integration patterns

p. 04 / 09

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

§05Ibni fid-dar vs. integra ScreenVeritAI

p. 05 / 09

Żmien sal-produzzjoni

Ibni fid-dar: 6-12-il xahar biex issib is-sorsi tal-listi, tibni t-tqabbil, timmaniġġja każijiet limitrofi
API ta' ScreenVeritAI: Ġranet biex tintegra — lest għall-produzzjoni mill-ewwel sejħa tal-API

Kopertura tal-listi tas-sanzjonijiet

Ibni fid-dar: Inġestjoni manwali ta' kull format ta' lista; manutenzjoni kontinwa tal-iskema
API ta' ScreenVeritAI: Kull sors ewlieni, miżmum u aġġornat kontinwament

Preċiżjoni tat-tqabbil

Ibni fid-dar: Tqabbil approssimattiv personalizzat jeħtieġ għarfien tal-NLP u aġġustament kostanti
API ta' ScreenVeritAI: AI b'tqabbil approssimattiv, traslitterazzjoni, riżoluzzjoni tal-aliases, algoritmi fonetiċi

PEP u midja avversa

Ibni fid-dar: Fornituri separati, integrazzjonijiet separati, budgets separati
API ta' ScreenVeritAI: Dejta PEP, midja avversa, u UBO fl-istess risposta tal-API

Manutenzjoni kontinwa

Ibni fid-dar: Tim dedikat għal aġġornamenti tal-listi, bidliet fl-iskema, aġġustament tal-pożittivi foloz
API ta' ScreenVeritAI: Ġestjoni sħiħa — aġġornamenti, titjib, u infrastruttura mmaniġġjati għalik

Traċċa tal-verifika

Ibni fid-dar: Ibni l-infrastruttura tiegħek stess ta' reġistrazzjoni, evidenza, u żamma
API ta' ScreenVeritAI: Pakketti ta' evidenza b'timbru taż-żmien b'referenzi tas-sors inklużi

Aspett

Ibni fid-dar

API ta' ScreenVeritAI

Żmien sal-produzzjoni

6-12-il xahar biex issib is-sorsi tal-listi, tibni t-tqabbil, timmaniġġja każijiet limitrofi

Ġranet biex tintegra — lest għall-produzzjoni mill-ewwel sejħa tal-API

Kopertura tal-listi tas-sanzjonijiet

Inġestjoni manwali ta' kull format ta' lista; manutenzjoni kontinwa tal-iskema

Kull sors ewlieni, miżmum u aġġornat kontinwament

Preċiżjoni tat-tqabbil

Tqabbil approssimattiv personalizzat jeħtieġ għarfien tal-NLP u aġġustament kostanti

AI b'tqabbil approssimattiv, traslitterazzjoni, riżoluzzjoni tal-aliases, algoritmi fonetiċi

PEP u midja avversa

Fornituri separati, integrazzjonijiet separati, budgets separati

Dejta PEP, midja avversa, u UBO fl-istess risposta tal-API

Manutenzjoni kontinwa

Tim dedikat għal aġġornamenti tal-listi, bidliet fl-iskema, aġġustament tal-pożittivi foloz

Ġestjoni sħiħa — aġġornamenti, titjib, u infrastruttura mmaniġġjati għalik

Traċċa tal-verifika

Ibni l-infrastruttura tiegħek stess ta' reġistrazzjoni, evidenza, u żamma

Pakketti ta' evidenza b'timbru taż-żmien b'referenzi tas-sors inklużi

§06Erba' passi lejn konformità integrata

p. 06 / 09

Ikseb l-API key tiegħek

Oħloq key bi skop definit mid-dashboard tiegħek b'permessi ta' privileġġ minimu: search:read, search:write, batch:read, batch:write.

Integra l-endpoint

Sejħa POST waħda lejn il-fluss tal-onboarding, tal-pagamenti, jew tas-CRM tiegħek — ibgħat l-isem tal-entità, it-tip, u l-pajjiż, u ikseb job ID lura.

Ipproċessa r-riżultati

Agħmel polling fuq l-endpoint tar-riżultati jew irċievi callback tal-webhook b'JSON strutturat — kuntest tal-kumpanija, sjieda, PEP, midja avversa, sinjali tas-sanzjonijiet, u punteġġi tar-riskju.

Immonitorja u avża

Ikkonfigura monitoraġġ kontinwu — l-API tibgħat avviżi meta l-listi tas-sanzjonijiet jiġu aġġornati jew tinstab midja avversa ġdida.

§07Ibda fi ftit minuti

p. 07 / 09

Sejħa waħda tal-API tirritorna riżultat sħiħ ta' skrining.

Iskrinja entità

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

Ikkontrolla r-riżultat

bash

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

§08Prestazzjoni tal-API

p. 08 / 09

Kollha

Sorsi ewlenin skrinjati għal kull sejħa tal-API

<2 min

Ħin medju ta' risposta għal skrining sħiħ b'deep research

99.9%

SLA tal-uptime tal-API għal integrazzjonijiet ta' produzzjoni

§09Mistoqsijiet Frekwenti dwar l-Integrazzjoni tal-API

p. 09 / 09

01Kif nawtentika talbiet tal-API?

Awtentika t-talbiet tal-API b'ċavetta sigrieta mgħoddija fl-header Authorization. Il-keys jinħolqu mid-dashboard tiegħek b'permessi bi skop definit u ta' privileġġ minimu.

02L-API hija sinkronika jew asinkronika?

Asinkronika. Issottometti talba, tikseb job ID, tirkupra r-riżultati permezz ta' polling jew webhook. Il-pipeline tiegħek qatt ma jissakkar.

03Liema format ta' risposta tirritorna l-API?

JSON strutturat bi tqabbiliet tas-sanzjonijiet, marki PEP, midja avversa, punteġġi ta' kunfidenza, referenzi tas-sors, u klassifikazzjoni tal-livell tar-riskju.

04Liema limiti tar-rata japplikaw?

Assenjati skont il-livell tas-sottoskrizzjoni għal kull API key. L-headers tar-risposta jinkludu l-kwota li fadal u l-marka taż-żmien tal-irkupru.

05Nista' niskrinja entitajiet bil-lott permezz tal-API?

Iva. L-endpoint tal-lott jaċċetta CSV jew XLSX sa 100 ringiela għal kull talba, bir-riżultati li jistgħu jiġu rkuprati għal kull ringiela jew bħala esportazzjoni sħiħa.

06Kif nissettja monitoraġġ kontinwu permezz tal-API?

Ikkonfigura l-monitoraġġ wara l-iskrining inizjali. Meta l-listi jiġu aġġornati jew tinstab midja avversa ġdida, l-API tibgħat webhook lejn l-endpoint tiegħek.

07Liema dejta ta' konformità hija inkluża f'kull riżultat ta' skrining?

Tqabbiliet tas-sanzjonijiet fost kull sors ewlieni, l-istatus PEP b'konnessjonijiet tal-familja, midja avversa b'ċitazzjonijiet f'ħafna lingwi, dejta tal-UBO, il-livell tar-riskju, u pakkett ta' evidenza b'timbru taż-żmien.

08Kemm jieħu żmien skrining?

Kontroll standard tas-sanzjonijiet: sekondi. Deep research bil-midja avversa u l-immappjar tas-sjieda: inqas minn żewġ minuti.

Terminoloġija tal-API

REST API

API tal-web li tuża metodi standard HTTP — kompatibbli ma' kwalunkwe lingwa jew qafas li jista' jagħmel talbiet HTTP.

Webhook

Callback HTTP server-to-server skattat meta skrining jitlesta jew il-monitoraġġ jikxef bidla.

Ipproċessar asinkroniku

L-API taċċetta xogħol minnufih u tipproċessah fil-background — irkupra r-riżultati permezz ta' polling jew webhook.

API key

Token sigriet biex jawtentika talbiet tal-API, bi skop definit b'permessi speċifiċi għal aċċess ta' privileġġ minimu.

Limitazzjoni tar-rata

Tirrestrinġi t-talbiet tal-API għal kull tieqa ta' ħin skont il-livell tas-sottoskrizzjoni — kwota li fadal u marki taż-żmien tal-irkupru fl-headers tar-risposta.

Risposta strutturata

JSON li tinqara mill-magni b'ismijiet u tipi konsistenti tal-oqsma, li jippermettu parsing awtomatiku u loġika ta' deċiżjoni.

Sorsi tal-industrija

01
FATF Guidance on Digital Identity and Customer Due Diligence
Financial Action Task Force
02
Regulatory Technology for AML/CFT Compliance
Bank for International Settlements — FSI Insights
03
OFAC Compliance Commitments Framework
U.S. Department of the Treasury
04
EU Anti-Money Laundering Authority (AMLA) Regulation
Official Journal of the European Union

Skopri aktar

End of API specification.

Għaliex tikkopja u tinkolla ismijiet bejn is-sistemi meta sejħa waħda tal-API tagħmilhom kollha?

§01The request

One POST call. That's your entire integration.

§02The response

Structured JSON. Every risk vector.

§03API reference

§04Integration patterns

§05Ibni fid-dar vs. integra ScreenVeritAI

§06Erba' passi lejn konformità integrata

§07Ibda fi ftit minuti

§08Prestazzjoni tal-API

§09Mistoqsijiet Frekwenti dwar l-Integrazzjoni tal-API

Iskrining tas-Sanzjonijiet

Iskrining tal-Klijenti u Due Diligence

Iskrining bil-Lott

Kopertura tal-Listi tas-Sanzjonijiet

Ibda skrining fi ftit minuti.