ScreenVeritAI
    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.

    Hae API-avainKatso hinnoittelu

    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

    Rakenna 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

    Neljä 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

    Kysele tulosten päätepistettä ja saat strukturoidun JSON-vastauksen — yrityskonteksti, omistus, PEP, kielteinen julkisuus, pakotesignaalit ja riskipisteet.

    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.

    Aloita minuuteissa

    p. 07 / 09

    Yksi API-kutsu palauttaa täydellisen tarkistustuloksen.

    Tarkista taho
    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 }
    Tarkista tulos
    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:n suorituskyky

    p. 08 / 09

    €0.39

    Quick Check per kutsu, ei alustamaksua

    202

    HTTP-tila, kun haku on hyväksytty; tulos noudetaan sen jälkeen

    EU

    Isännöity Suomessa; tallennettu data pysyy EU:ssa

    API-integraation UKK

    p. 09 / 09
    01Miten API-pyynnöt todennetaan?
    Kaikki API-pyynnöt todennetaan API-avaimella, joka välitetään X-API-Key-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?
    Asynkroninen. Lähetä pyyntö, saat työtunnuksen ja noudat tulokset kyselemällä. Putkesi ei koskaan esteydy.
    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?
    Konfiguroi seuranta ensimmäisen seulonnan jälkeen. Kun listat päivittyvät tai uutta kielteistä julkisuutta ilmaantuu, seuranta merkitsee muutoksen ja hälyttää sinut sovelluksessa.
    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ä.
    Asynkroninen käsittely
    API hyväksyy työn heti ja käsittelee sen taustalla — nouda tulokset kyselemällä.
    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
    Tutustu lisää

    Pakoteseulontaohjelmisto

    Vertaa pakotelistojen kattavuutta, sumeaa nimihakua, lähdeviitteitä, seurantaa ja auditointijälkeä.

    Asiakasseulonta ja tuntemisvelvollisuus

    Mene pakoteluetteloiden yli — kartoita omistajuus, PEP-altistus ja kielteinen julkisuus täydellisiin riskiprofiileihin.

    Erätarkistus

    Lataa CSV- tai XLSX-tiedostoja ja tarkista satoja tahoja kaikkia pakotejärjestelmiä vasten yhdellä työnä.

    Pakoteluetteloiden kattavuus

    Katso jokainen pakoteluettelo, PEP-tietokanta ja lainkäyttöalue, jonka ScreenVeritAI kattaa.

    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.

    Katso hinnoittelu