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.

    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

    Ehitada 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

    Neli 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

    Pollige tulemuste lõpp-punkti struktureeritud JSON-i saamiseks — ettevõtte kontekst, omandistruktuur, PEP, negatiivne meedia, sanktsioonisignaalid ja riskiskoorid.

    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.

    Alustage minutitega

    p. 07 / 09

    Üks API-kutse tagastab täieliku kontrollimistulemuse.

    Kontrollige üksust
    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 }
    Kontrollige tulemust
    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 jõudlus

    p. 08 / 09

    €0.39

    Quick Check päringu kohta, ilma platvormitasuta

    202

    HTTP-olek, kui otsing on vastu võetud; tulemust päritakse seejärel

    EU

    Majutatud Soomes; salvestatud andmed jäävad ELi

    API integratsiooni KKK

    p. 09 / 09
    01Kuidas autentida API-päringuid?
    Kõik API-päringud autentitakse API-võtmega, mis edastatakse X-API-Key-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?
    Asünkroonne. Saadate päringu, saate töö ID ja saate tulemused kätte pollimise teel. Teie konveier ei blokeeru kunagi.
    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?
    Konfigureerige seire pärast esialgset kontrollimist. Kui nimekirju uuendatakse või ilmneb uus negatiivne meedia, märgib seire muutuse ja teavitab teid rakenduses.
    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.
    Asünkroonne töötlus
    API võtab töö kohe vastu ja töötleb seda taustal — tulemused saate kätte pollimise teel.
    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.