ScreenVeritAI · API Specv1 · GA · reference
    Kehittäjä-API

    Liitä pakoteseulonta omaan työnkulkuusi API:lla

    ScreenVeritAI:n API tuo pakote-, PEP- ja rikollisuuden tarkkailulistojen seulonnan sinne, missä päätös tehdään — esimerkiksi asiakkaan rekisteröitymiseen, maksun hyväksyntään tai CRM-järjestelmään. Tulos palautuu strukturoituna JSON-datana, jonka voi ohjata suoraan tarkistukseen ja päätöslogiikkaan.

    §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

    §05Rakenna vai osta

    p. 05 / 09
    Aika tuotantoon
    Rakenna itse
    6–12 kuukautta luetteloiden hankkimiseen, vertailulogiikan rakentamiseen ja reunatapausten käsittelyyn
    ScreenVeritAI API
    Päiviä integrointiin; tuotantovalmis ensimmäisestä API-kutsusta
    Pakoteluetteloiden kattavuus
    Rakenna itse
    Kunkin luettelomuodon manuaalinen syöttö; jatkuva ylläpito skeemojen muuttuessa
    ScreenVeritAI API
    Jokainen merkittävä lähde ylläpidettynä ja jatkuvasti päivitettynä
    Vertailun tarkkuus
    Rakenna itse
    Räätälöity sumea vertailu vaatii NLP-asiantuntemusta ja jatkuvaa virittämistä
    ScreenVeritAI API
    Tekoälyagentti sumealla vertailulla, translitteroinnilla, aliasratkaisulla ja foneettisilla algoritmeilla
    PEP ja kielteinen julkisuus
    Rakenna itse
    Erilliset datan toimittajat, erilliset integraatiot, erilliset budjetit
    ScreenVeritAI API
    PEP-, kielteisen julkisuuden ja tosiasiallisten omistajien tiedot sisältyvät samaan API-vastaukseen
    Jatkuva ylläpito
    Rakenna itse
    Dedikoitu insinööritiimi luettelopäivityksille, skeemamuutoksille ja väärien positiivisten virittämiselle
    ScreenVeritAI API
    Täysin hallittu — luettelopäivitykset, mallien parannukset ja infrastruktuuri hoidettu puolestasi
    Kirjausketju
    Rakenna itse
    Rakenna oma kirjaamis-, todisteiden luomis- ja säilytysinfrastruktuurisi
    ScreenVeritAI API
    Aikaleimalla varustetut todisteet lähdeviitteineen ja päätöksen perusteluineen sisältyvät

    §06Neljä vaihetta tuotantoon

    p. 06 / 09
    1

    Hae API-avaimesi

    Luo rajattu API-avain ScreenVeritAI-hallintapaneelista. Määritä oikeudet — search:read, search:write, batch:read, batch:write — vähimmäisoikeuksien käyttöoikeuksille.

    2

    Integroi päätepiste

    Lisää yksi POST-kutsu liittymis-, maksu- tai CRM-työnkulkuusi. Lähetä tahon nimi, tyyppi ja maa. API palauttaa työtunnuksen asynkroniseen tulosten noutoon.

    3

    Käsittele tulokset

    Kysy tulosten päätepisteestä tai vastaanota webhook-takaisinkutsu. Jäsennä strukturoitu JSON-vastaus — pakoteosamat, PEP-merkinnät, kielteisen julkisuuden osumat ja riskipisteet — ja ohjaa päätöslogiikkaasi.

    4

    Seuraa ja hälytä

    Konfiguroi jatkuva seuranta tarkistetuille tahoille. Kun pakoteluetteloita päivitetään tai uutta kielteistä julkisuutta ilmaantuu, API lähettää hälytyksiä, jotta järjestelmäsi voi käynnistää uusintatarkistuksen automaattisesti.

    §07Aloita minuuteissa

    p. 07 / 09

    Yksi API-kutsu palauttaa täydellisen tarkistustuloksen.

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

    §08API:n suorituskyky

    p. 08 / 09

    Kaikki

    Merkittävät lähteet tarkistettu yhdellä API-kutsulla

    <2 min

    Keskimääräinen vasteaika täydelliseen tarkistukseen syvätutkimuksella

    99.9%

    API:n käytettävyys-SLA tuotantointegraatioille

    §09API-integraation UKK

    p. 09 / 09
    01Miten API-pyynnöt todennetaan?
    Kaikki API-pyynnöt todennetaan API-avaimella, joka välitetään Authorization-otsikossa. Avaimet luodaan ScreenVeritAI-hallintapaneelista rajatuilla oikeuksilla (search:read, search:write, batch:read, batch:write) vähimmäisoikeuksien käyttöoikeuden noudattamiseksi.
    02Onko API synkroninen vai asynkroninen?
    API käyttää asynkronista käsittelymallia. Lähetät tarkistuspyynnön POST-metodilla ja saat heti työtunnuksen. Tulokset noudetaan tulosten päätepisteestä kyselyllä tai konfiguroimalla webhook-takaisinkutsu. Tämä estää tuotantoputkistosi estymisen tekoälyagentin suorittaessa analyysiään.
    03Missä muodossa API palauttaa vastauksen?
    Kaikki vastaukset ovat strukturoitua JSON:ia johdonmukaisilla kenttänimillä ja -tyypeillä. Tarkistustulokset sisältävät pakoteosumien yksityiskohdat, PEP-merkinnät, kielteisen julkisuuden osumat, luottamuspisteet, lähdeviitteet ja riskitasoluokituksen — valmiina automatisoituun jäsentämiseen ja päätöslogiikkaan ilman manuaalista eristämistä.
    04Mitkä nopeusrajoitukset pätevät?
    Nopeusrajoitukset määräytyvät tilaustasojen mukaan ja niitä sovelletaan API-avainkohtaisesti. Vastausotsikot sisältävät nykyisen rajasi, jäljellä olevan kiintiön ja nollausaikaleiman. Jos tarvitset suurempaa läpimenoa massatarkistukseen, eräpäätepiste hyväksyy CSV/XLSX-latauksia suurten volyymien tarkistukseen.
    05Voinko tarkistaa tahoja erässä API:n kautta?
    Kyllä. Eräpäätepiste hyväksyy CSV- tai XLSX-tiedostoja, joissa on enintään 100 riviä pyyntöä kohti. Jokainen rivi käsitellään yksittäisenä tarkistuksena, ja tulokset ovat noudettavissa rivin mukaan tai täydellisenä ladattavana vientinä työn valmistuessa.
    06Miten jatkuva seuranta asetetaan API:n kautta?
    Alkuperäisen tarkistuksen jälkeen voit konfiguroida seurannan tarkastetulle taholle. Kun pakoteluetteloita päivitetään tai uutta kielteistä julkisuutta ilmaantuu, API lähettää webhook-ilmoituksen konfiguroimaasi päätepisteeseen, jotta järjestelmäsi voi käynnistää uusintatarkistuksen tai eskaloinnin automaattisesti.
    07Mitä vaatimustenmukaisuustietoja sisältyy kuhunkin tarkistustulokseen?
    Jokainen tulos sisältää pakoteosamat jokaisesta merkittävästä lähteestä, PEP-aseman perhe- ja lähipiiriyhteyksineen, kielteisen julkisuuden osumat monikielisine lähdeviitteineen, tosiasiallisten omistajien omistustiedot, riskitasoluokituksen ja aikaleimalla varustetun todistepaketin, joka soveltuu auditointiin ja sääntelyarviointiin.
    08Kuinka kauan tarkistus kestää?
    Tavanomainen pakoteseuranta valmistuu tyypillisesti sekunneissa. Syvätutkimustarkistus — mukaan lukien kielteisen julkisuuden analyysi ja omistuskartoitus — kestää keskimäärin alle kaksi minuuttia. Asynkroninen malli tarkoittaa, että järjestelmäsi ei koskaan esty odottaessaan tuloksia.
    API-terminologia
    REST API
    Web API -arkkitehtuuri, joka käyttää standardeja HTTP-menetelmiä (GET, POST, PUT, DELETE) resurssien kanssa vuorovaikutukseen. ScreenVeritAI:n API noudattaa REST-käytäntöjä, mikä tekee siitä yhteensopivan minkä tahansa kielen tai kehyksen kanssa, joka osaa tehdä HTTP-pyyntöjä.
    Webhook
    Palvelimelta palvelimelle HTTP-takaisinkutsu, jonka tapahtuma laukaisee. Tulosten kyselyn sijaan voit konfiguroida ScreenVeritAI:n lähettämään POST-pyynnön päätepisteeseesi, kun tarkistus valmistuu tai jatkuva seuranta havaitsee muutoksen.
    Asynkroninen käsittely
    Pyyntömalli, jossa API hyväksyy työn välittömästi ja käsittelee sen taustalla. Asiakas saa työtunnuksen ja noutaa tulokset myöhemmin kyselyllä tai webhookilla. Tämä malli estää estymisen tuotantoputkistoissa.
    API-avain
    Salainen tunnus, jota käytetään palvelimelta palvelimelle API-pyyntöjen todentamiseen. ScreenVeritAI API -avaimilla on rajatut oikeudet (search:read, search:write, batch:read, batch:write) vähimmäisoikeuksien käyttöoikeusmallien noudattamiseksi.
    Nopeusrajoitus
    Mekanismi, joka rajoittaa API-pyyntöjen määrää, jonka asiakas voi tehdä annetun aikaikkunan sisällä. Nopeusrajoitukset määräytyvät tilaustasojen mukaan ja välitetään vastausotsikoiden kautta, mukaan lukien jäljellä oleva kiintiö ja nollausaikaleima.
    Strukturoitu vastaus
    Koneluettava API-vastausmuoto (JSON) johdonmukaisilla kenttänimillä, tyypeillä ja sisäkkäisyydellä. Strukturoidut vastaukset mahdollistavat automatisoidun jäsentämisen, päätöslogiikan ja kirjausketjun luomisen ilman manuaalista tietojen eristämistä.
    Toimialalähteet
    1. 01
    2. 02
      Sääntelyteknologia AML/CFT-vaatimustenmukaisuuteen

      Kansainvälinen järjestelypankki — FSI Insights

    3. 03
      OFAC:in vaatimustenmukaisuussitoumuskehys

      Yhdysvaltain valtiovarainministeriö

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

    End of API specification.

    Aloita seulonta minuuteissa.

    Valitse sopiva paketti ja aloita seulonta jo tänään.