# Kehittäjä-API

    Upota vaatimustenmukaisuustarkistus mihin tahansa työnkulkuun

    $

    Liittymisprosessisi, maksuporttiisi ja CRM:si tekevät jo päivittäin riskipäätöksiä. ScreenVeritAI:n API mahdollistaa pakoteseurannan, PEP-tarkistusten, negatiivisen median analyysin ja tosiasiallisten omistajien kartoituksen upottamisen suoraan näihin työnkulkuihin — ei manuaalisia hakuja, ei kopioi-liitä-toimintoja, ei vaatimustenmukaisuusaukkoja järjestelmien välillä. Yksi API-kutsu käynnistää saman tekoälyagentin, joka ohjaa alustaamme, ja strukturoitu JSON palautuu valmiina päätösmoottorilesi.

    // The request

    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 "deep_research"
    POST /v1/screenbash
    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": "deep_research"
    8 }'
    POST /api/v1/screen — response200 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

    // The response

    Structured JSON. Every risk vector. Color-coded.

    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

    // Endpoints

    API Reference

    Three endpoints cover all screening workflows.

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

    Response

    200 OK
    { "request_id": "srv_a8f3c1d9", "status": "queued",
    "estimated_seconds": 30, "poll_url": "/v1/result/srv_a8f3c1d9" }

    // Integration patterns

    Drop into your existing workflow

    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

    // Build vs buy

    Rakenna vai osta

    NäkökohtaRakenna itseScreenVeritAI API
    Aika tuotantoon6–12 kuukautta luetteloiden hankkimiseen, vertailulogiikan rakentamiseen ja reunatapausten käsittelyynPäiviä integrointiin; tuotantovalmis ensimmäisestä API-kutsusta
    Pakoteluetteloiden kattavuusKunkin luettelomuodon manuaalinen syöttö; jatkuva ylläpito skeemojen muuttuessaYli 10 järjestelmää ylläpidetty ja jatkuvasti päivitetty — OFAC, EU, YK, UK ja muut
    Vertailun tarkkuusRäätälöity sumea vertailu vaatii NLP-asiantuntemusta ja jatkuvaa virittämistäTekoälyagentti sumealla vertailulla, translitteroinnilla, aliasratkaisulla ja foneettisilla algoritmeilla
    PEP ja negatiivinen mediaErilliset datan toimittajat, erilliset integraatiot, erilliset budjetitPEP-, negatiivisen median ja tosiasiallisten omistajien tiedot sisältyvät samaan API-vastaukseen
    Jatkuva ylläpitoDedikoitu insinööritiimi luettelopäivityksille, skeemamuutoksille ja väärien positiivisten virittämiselleTäysin hallittu — luettelopäivitykset, mallien parannukset ja infrastruktuuri hoidettu puolestasi
    KirjausketjuRakenna oma kirjaamis-, todisteiden luomis- ja säilytysinfrastruktuurisiAikaleimalla varustetut todisteet lähdeviitteineen ja päätöksen perusteluineen sisältyvät

    // How it works

    Neljä vaihetta tuotantoon

    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, negatiivisen median 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 negatiivista mediaa ilmaantuu, API lähettää hälytyksiä, jotta järjestelmäsi voi käynnistää uusintatarkistuksen automaattisesti.

    // Quickstart examples

    Aloita minuuteissa

    Yksi API-kutsu palauttaa täydellisen tarkistustuloksen.

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

    API:n suorituskyky

    10+

    Globaalia pakotejärjestelmää tarkistettu yhdellä API-kutsulla

    <2 min

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

    99.9%

    API:n käytettävyys-SLA tuotantointegraatioille

    // FAQ

    API-integraation UKK

    #Miten 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.
    #Onko 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.
    #Missä 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, negatiivisen median osumat, luottamuspisteet, lähdeviitteet ja riskitasoluokituksen — valmiina automatisoituun jäsentämiseen ja päätöslogiikkaan ilman manuaalista eristämistä.
    #Mitkä 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.
    #Voinko 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.
    #Miten jatkuva seuranta asetetaan API:n kautta?
    Alkuperäisen tarkistuksen jälkeen voit konfiguroida seurannan tarkastetulle taholle. Kun pakoteluetteloita päivitetään tai uutta negatiivista mediaa ilmaantuu, API lähettää webhook-ilmoituksen konfiguroimaasi päätepisteeseen, jotta järjestelmäsi voi käynnistää uusintatarkistuksen tai eskaloinnin automaattisesti.
    #Mitä vaatimustenmukaisuustietoja sisältyy kuhunkin tarkistustulokseen?
    Jokainen tulos sisältää pakoteosamat yli 10 järjestelmän yli, PEP-aseman perhe- ja lähipiiriyhteyksineen, negatiivisen median osumat monikielisine lähdeviitteineen, tosiasiallisten omistajien omistustiedot, riskitasoluokituksen ja aikaleimalla varustetun todistepaketin, joka soveltuu auditointiin ja sääntelyarviointiin.
    #Kuinka kauan tarkistus kestää?
    Tavanomainen pakoteseuranta valmistuu tyypillisesti sekunneissa. Syvätutkimustarkistus — mukaan lukien negatiivisen median 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. [1]
    2. [2]
      Sääntelyteknologia AML/CFT-vaatimustenmukaisuuteen

      Kansainvälinen järjestelypankki — FSI Insights

    3. [3]
      OFAC:in vaatimustenmukaisuussitoumuskehys

      Yhdysvaltain valtiovarainministeriö

    4. [4]

    Aloita tarkistus minuuteissa.

    Luottokorttia ei vaadita.