ScreenVeritAI · API Specv1 · GA · reference
    Arendaja API

    Lisage sanktsioonide kontroll oma töövoogu

    ScreenVeritAI API käivitab sanktsioonide, PEP-i, kriminaalnimekirjade ja negatiivse meedia kontrolli seal, kus otsus tehakse — näiteks kliendi liitumisel, makse kinnitamisel või CRM-is. Vastus saabub struktureeritud JSON-ina ja selle saab suunata otse teie otsustusloogikasse.

    §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
    1{
    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

    §05Ehitada või osta

    p. 05 / 09
    Aeg tootmiseni
    Ehitada ise
    6–12 kuud nimekirjade hankimiseks, sobitamisloogika ehitamiseks ja erijuhtude käsitlemiseks
    ScreenVeritAI API
    Päevad integreerimiseks; tootmisvalmis esimesest API-kutsest
    Sanktsiooninimekirjade katvus
    Ehitada ise
    Iga nimekirja formaadi käsitsi sisestamine; pidev hooldus skeemide muutudes
    ScreenVeritAI API
    Iga suurem allikas hooldatud ja pidevalt uuendatud — OFAC, EL, ÜRO, Ühendkuningriik ja rohkem
    Sobitamise täpsus
    Ehitada ise
    Kohandatud hägune sobitamine nõuab NLP-ekspertiisi ja pidevat häälestamist
    ScreenVeritAI API
    TI-agent häguse sobitamise, transliteratsiooni, varjunimede lahendamise ja foneetiliste algoritmidega
    PEP ja negatiivne meedia
    Ehitada ise
    Eraldi andmepakkujad, eraldi integratsioonid, eraldi eelarved
    ScreenVeritAI API
    PEP, negatiivse meedia ja tegelike kasusaajate andmed sisalduvad samas API-vastuses
    Pidev hooldus
    Ehitada ise
    Pühendatud insenerimeeskond nimekirjade uuenduste, skeemimuutuste ja valepositiivsete häälestamise jaoks
    ScreenVeritAI API
    Täielikult hallatav — nimekirjade uuendused, mudeli parandused ja infrastruktuur käideldakse teie eest
    Auditijälg
    Ehitada ise
    Ehitage oma logimise, tõendite genereerimise ja säilitamise infrastruktuur
    ScreenVeritAI API
    Ajatempliga tõendipaketid allikaviidete ja otsuse põhjendusega sisalduvad

    §06Neli sammu tootmiseni

    p. 06 / 09
    1

    Saage oma API-võti

    Looge piiritletud API-võti ScreenVeritAI juhtpaneelilt. Määrake õigused — search:read, search:write, batch:read, batch:write — vähimate privileegide juurdepääsuks.

    2

    Integreerige lõpp-punkt

    Lisage üks POST-kutse oma liitumise, maksete või CRM-i töövoole. Saatke üksuse nimi, tüüp ja riik. API tagastab töö ID asünkroonseks tulemuste saamiseks.

    3

    Töötlege tulemused

    Küsitlege tulemuste lõpp-punkti või saage veebihaagi tagasikutse. Parsige struktureeritud JSON-vastus — sanktsioonivasted, PEP-märgistused, negatiivse meedia leiud ja riskiskoorid — ning suunake oma otsusteloogikasse.

    4

    Jälgige ja teavitage

    Konfigureerige pidev jälgimine kontrollitud üksuste jaoks. Kui sanktsiooninimekirju uuendatakse või ilmneb uus negatiivne meedia, saadab API teavitusi, et teie süsteem saaks automaatselt käivitada taaskontrolli.

    §07Alustage minutitega

    p. 07 / 09

    Üks API-kutse tagastab täieliku kontrollimistulemuse.

    Kontrollige üksust
    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"}'
    Kontrollige tulemust
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08API jõudlus

    p. 08 / 09

    Kõik

    Peamised allikad kontrollitud ühe API-kutsega

    <2 min

    Keskmine vastamise aeg täielikuks kontrollimiseks koos süvauuringuga

    99.9%

    API tööaja SLA tootmisintegratsioonide jaoks

    §09API integratsiooni KKK

    p. 09 / 09
    01Kuidas autentida API-päringuid?
    Kõik API-päringud autentitakse API-võtmega, mis edastatakse Authorization-päises. Võtmed luuakse ScreenVeritAI juhtpaneelilt piiritletud õigustega (search:read, search:write, batch:read, batch:write) vähimate privileegide juurdepääsu tagamiseks.
    02Kas API on sünkroonne või asünkroonne?
    API kasutab asünkroonset töötlusmudelit. Esitate kontrollimispäringu POST-meetodiga ja saate kohe töö ID. Tulemused hangitakse tulemuste lõpp-punkti küsitluse või veebihaagi tagasikutse konfiguratsiooni kaudu. See hoiab ära teie tootmisprotsessi blokeerumise, kuni TI-agent oma analüüsi lõpetab.
    03Millist vastuse formaati API tagastab?
    Kõik vastused on struktureeritud JSON järjepidevate väljanimetuste ja -tüüpidega. Kontrollimistulemused sisaldavad sanktsioonivaste üksikasju, PEP-märgistusi, negatiivse meedia leide, usaldusskoorisid, allikaviiteid ja riskitaseme klassifikatsiooni — valmis automatiseeritud parsimiseks ja otsusteloogikaks ilma käsitsi eraldamiseta.
    04Millised kiirusepiirangud kehtivad?
    Kiirusepiirangud määratakse tellimusetaseme järgi ja jõustatakse API-võtme kaupa. Vastuse päised sisaldavad teie praegust limiiti, järelejäänud kvooti ja lähtestamise ajatemplit. Kui vajate suuremat läbilaskevõimet massitöötluseks, aktsepteerib pakklõpp-punkt CSV/XLSX üleslaadimisi suure mahuga kontrollimiseks.
    05Kas saan kontrollida üksusi pakina API kaudu?
    Jah. Pakklõpp-punkt aktsepteerib CSV- või XLSX-faile kuni 100 reaga päringu kohta. Iga rida töödeldakse individuaalse kontrollimisena ja tulemused on kättesaadavad rea kaupa või täieliku allalaetava ekspordina, kui töö lõpeb.
    06Kuidas seadistada pidevat jälgimist API kaudu?
    Pärast esialgset kontrollimist saate konfigureerida jälgimise kontrollitud üksuse jaoks. Kui sanktsiooninimekirju uuendatakse või ilmneb uus negatiivne meedia, saadab API veebihaagi teavituse teie konfigureeritud lõpp-punktile, et teie süsteem saaks automaatselt käivitada taaskontrolli või eskalatsiooni.
    07Millised vastavusandmed sisalduvad igas kontrollimistulemustes?
    Iga tulemus sisaldab sanktsioonivasteid kõigi peamiste allikate ulatuses, PEP-staatust koos pere ja kaastöötajate seostega, negatiivse meedia leide mitmekeelsete allikaviidatega, tegelike kasusaajate omandiandmeid, riskitaseme klassifikatsiooni ja ajatempliga tõendipakett, mis sobib auditiks ja regulatiivseks ülevaatuseks.
    08Kui kaua kontrollimine kestab?
    Standardne sanktsioonikontroll valmib tavaliselt sekunditega. Süvauuringu kontrollimine — sealhulgas negatiivse meedia analüüs ja omandi kaardistamine — kestab keskmiselt alla kahe minuti. Asünkroonne mudel tähendab, et teie süsteem ei blokeeru kunagi tulemusi oodates.
    API terminoloogia
    REST API
    Veebi API arhitektuur, mis kasutab standardseid HTTP-meetodeid (GET, POST, PUT, DELETE) ressurssidega suhtlemiseks. ScreenVeritAI API järgib REST-konventsioone, muutes selle ühilduvaks mis tahes keele või raamistikuga, mis suudab teha HTTP-päringuid.
    Veebihaak
    Serverilt-serverile HTTP tagasikutse, mille käivitab sündmus. Tulemuste küsitlemise asemel saate konfigureerida ScreenVeritAI-d saatma POST-päringu teie lõpp-punktile, kui kontrollimine lõpeb või pidev jälgimine tuvastab muutuse.
    Asünkroonne töötlus
    Päringu mudel, kus API aktsepteerib töö kohe ja töötleb seda taustal. Klient saab töö ID ja hangib tulemused hiljem küsitluse või veebihaagi kaudu. See muster hoiab ära blokeerumise tootmisprotsessides.
    API-võti
    Salajane token, mida kasutatakse serveri-serveri API-päringute autentimiseks. ScreenVeritAI API-võtmed on piiritletud konkreetsete õigustega (search:read, search:write, batch:read, batch:write) vähimate privileegide juurdepääsumustrite tagamiseks.
    Kiirusepiirang
    Mehhanism, mis piirab API-päringute arvu, mida klient saab antud ajaaknas teha. Kiiruspiirangud määratakse tellimusetaseme järgi ja edastatakse vastuse päiste kaudu, sealhulgas järelejäänud kvoodi ja lähtestamise ajatemplid.
    Struktureeritud vastus
    Masinloetav API vastuse formaat (JSON) järjepidevate väljade nimede, tüüpide ja pesastumisega. Struktureeritud vastused võimaldavad automatiseeritud parsimist, otsusteloogikat ja auditijälje genereerimist ilma käsitsi andmete eraldamiseta.
    Valdkondlikud allikad
    1. 01
    2. 02
      Regulatiivne tehnoloogia AML/CFT vastavuse jaoks

      Rahvusvaheline Arvelduste Pank — FSI ülevaated

    3. 03
      OFAC vastavuskohustuste raamistik

      USA Rahandusministeerium

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

    End of API specification.

    Alustage kontrollimist minutitega.

    Valige plaan ja alustage kontrollimist juba täna.