ScreenVeritAI · API Specv1 · GA · reference
    Kūrėjų API

    Kam kopijuoti pavadinimus tarp sistemų, jei viską atlieka viena API užklausa?

    Įtraukite įmonių patikrą, nuosavybės struktūros atvaizdavimą, politiškai pažeidžiamų (paveikiamų) asmenų (PEP) patikras, neigiamą žiniasklaidą (angl. „adverse media“) ir sankcijų signalus tiesiai į savo esamas darbo eigas.

    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

    Kurti savoje sistemoje ar integruoti ScreenVeritAI

    p. 05 / 09
    Laikas iki gamybos
    Kurti savoje sistemoje
    6–12 mėnesių sąrašams surinkti, atitikimui sukurti ir kraštiniams atvejams apdoroti
    ScreenVeritAI API
    Kelios dienos integracijai — paruošta gamybai nuo pirmos API užklausos
    Sankcijų sąrašų aprėptis
    Kurti savoje sistemoje
    Rankinis kiekvieno sąrašo formato įkėlimas; nuolatinė schemų priežiūra
    ScreenVeritAI API
    Kiekvienas pagrindinis šaltinis, nuolat prižiūrimas ir atnaujinamas
    Atitikimo tikslumas
    Kurti savoje sistemoje
    Individualus apytikslis atitikimas reikalauja NLP kompetencijos ir nuolatinio derinimo
    ScreenVeritAI API
    DI su apytiksliu atitikimu, transliteracija, alternatyvių vardų atpažinimu ir fonetiniais algoritmais
    PEP ir neigiama žiniasklaida
    Kurti savoje sistemoje
    Atskiri tiekėjai, atskiros integracijos, atskiri biudžetai
    ScreenVeritAI API
    PEP, neigiamos žiniasklaidos ir UBO duomenys tame pačiame API atsakyme
    Nuolatinė priežiūra
    Kurti savoje sistemoje
    Speciali komanda sąrašų atnaujinimams, schemų pokyčiams ir klaidingų atitikmenų derinimui
    ScreenVeritAI API
    Visiškai valdoma — atnaujinimai, patobulinimai ir infrastruktūra tvarkomi už jus
    Audito seka
    Kurti savoje sistemoje
    Kurkite savo registravimo, įrodymų ir saugojimo infrastruktūrą
    ScreenVeritAI API
    Laiko žyma pažymėti įrodymų paketai su šaltinių nuorodomis

    Keturi žingsniai iki integruotos atitikties

    p. 06 / 09
    1

    Gaukite API raktą

    Valdymo skydelyje sukurkite apribotų teisių raktą su mažiausios privilegijos teisėmis: search:read, search:write, batch:read, batch:write.

    2

    Integruokite galinį tašką

    Vienas POST kvietimas jūsų priėmimo, mokėjimų ar CRM darbo eigoje — nusiųskite subjekto pavadinimą, tipą ir šalį, gaukite užduoties ID.

    3

    Apdorokite rezultatus

    Apklauskite rezultatų galinį tašką ir gaukite struktūrizuotą JSON — įmonės kontekstą, nuosavybę, PEP, neigiamą žiniasklaidą, sankcijų signalus ir rizikos įverčius.

    4

    Stebėkite ir įspėkite

    Sukonfigūruokite nuolatinę stebėseną (Beta) — API atsiunčia įspėjimus, kai atnaujinami sankcijų sąrašai arba iškyla nauja neigiama žiniasklaida.

    Pradėkite per kelias minutes

    p. 07 / 09

    Viena API užklausa grąžina visą patikros rezultatą.

    Patikrinkite subjektą
    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 }
    Patikrinkite rezultatą
    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 našumas

    p. 08 / 09

    €0.39

    Quick Check už vieną užklausą, be platformos mokesčio

    202

    HTTP būsena priėmus paiešką; rezultatas vėliau užklausiamas

    EU

    Talpinama Suomijoje; saugomi duomenys lieka ES

    API integracijos DUK

    p. 09 / 09
    01Kaip autentifikuoti API užklausas?
    Autentifikuokite API užklausas slaptu raktu, perduodamu X-API-Key antraštėje. Raktai kuriami valdymo skydelyje su apribotomis, mažiausio būtino lygio teisėmis.
    02API sinchroninis ar asinchroninis?
    Asinchroninis. Pateikiate užklausą, gaunate užduoties ID, o rezultatus atsiimate apklausos būdu. Jūsų procesas niekada neblokuojamas.
    03Kokį atsakymo formatą grąžina API?
    Struktūrizuotą JSON su sankcijų atitikmenimis, PEP žymėmis, neigiama žiniasklaida, patikimumo balais, šaltinių nuorodomis ir rizikos lygio klasifikacija.
    04Kokios užklausų ribos taikomos?
    Priskiriamos pagal prenumeratos pakopą kiekvienam API raktui. Atsakymo antraštėse pateikiama likusi kvota ir atkūrimo laiko žyma.
    05Ar galiu tikrinti subjektus masiškai per API?
    Taip. Masinės patikros galinis taškas priima CSV arba XLSX su iki 100 eilučių per užklausą; rezultatus galima atsiimti pagal eilutę arba kaip visą eksportą.
    06Kaip per API nustatyti nuolatinę stebėseną (Beta)?
    Stebėseną sukonfigūruokite po pradinės patikros. Kai atnaujinami sąrašai arba iškyla nauja neigiama žiniasklaida, stebėsena pažymi pokytį ir įspėja jus programoje.
    07Kokie atitikties duomenys įtraukiami į kiekvieną patikros rezultatą?
    Sankcijų atitikmenys pagal kiekvieną pagrindinį šaltinį, PEP statusas su šeimos ryšiais, neigiama žiniasklaida su daugiakalbėmis nuorodomis, UBO duomenys, rizikos lygis ir laiko žyma pažymėtas įrodymų paketas.
    08Kiek trunka patikra?
    Standartinė sankcijų patikra — kelios sekundės. Gilusis tyrimas su neigiama žiniasklaida ir nuosavybės atvaizdavimu — mažiau nei dvi minutės.
    API terminija
    REST API
    Žiniatinklio API, naudojanti standartinius HTTP metodus — suderinama su bet kuria kalba ar karkasu, galinčiu siųsti HTTP užklausas.
    Asinchroninis apdorojimas
    API iš karto priima užduotį ir apdoroja ją fone — rezultatus atsiimkite apklausos (polling) būdu.
    API raktas
    Slaptasis žetonas API užklausoms autentifikuoti, apribotas konkrečiomis teisėmis mažiausios privilegijos prieigai.
    Užklausų ribojimas
    Riboja API užklausų skaičių per laiko langą pagal prenumeratos pakopą — likusi kvota ir atkūrimo laiko žymos pateikiamos atsakymo antraštėse.
    Struktūrizuotas atsakymas
    Mašininiu būdu nuskaitomas JSON su nuosekliais laukų pavadinimais ir tipais, leidžiantis automatinį apdorojimą ir sprendimų logiką.
    Pramonės šaltiniai
    1. 01
    2. 02
      Reguliacinės technologijos AML/CFT atitikčiai

      Tarptautinių atsiskaitymų bankas — FSI įžvalgos

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

    End of API specification.

    Pradėkite patikrą per kelias minutes.

    Pasirinkite planą ir pradėkite tikrinti jau šiandien.