ScreenVeritAI · API Specv1 · GA · reference
    Utvecklar-API

    Bädda in compliancescreening i valfritt arbetsflöde

    Din onboardingpipeline, betalningsgateway och ditt CRM hanterar redan riskbeslut varje dag. ScreenVeritAI:s API låter dig bädda in sanktionsscreening, PEP-kontroller, negativ mediaanalys och UBO-kartläggning direkt i dessa arbetsflöden — inga manuella sökningar, ingen kopiera-klistra, inga complianceluckor mellan system. Ett API-anrop startar samma AI-agent som driver vår plattform, och strukturerad JSON returneras redo för din beslutsmotor.

    §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

    §05Bygga själv kontra köpa

    p. 05 / 09
    Tid till produktion
    Bygga internt
    6–12 månader för att hämta listor, bygga matchningslogik och hantera specialfall
    ScreenVeritAI API
    Dagar att integrera; produktionsklart från första API-anropet
    Sanktionslisttäckning
    Bygga internt
    Manuell inmatning av varje listformat; löpande underhåll när scheman ändras
    ScreenVeritAI API
    Varje stor källa, underhållen och uppdaterad kontinuerligt — OFAC, EU, FN, UK och fler
    Matchningsnoggrannhet
    Bygga internt
    Anpassad fuzzy matching kräver NLP-expertis och kontinuerlig finjustering
    ScreenVeritAI API
    AI-agent med fuzzy matching, translitterering, aliasupplösning och fonetiska algoritmer
    PEP och negativ media
    Bygga internt
    Separata dataleverantörer, separata integrationer, separata budgetar
    ScreenVeritAI API
    PEP, negativ media och UBO-data ingår i samma API-svar
    Löpande underhåll
    Bygga internt
    Dedikerat ingenjörsteam för listuppdateringar, schemaändringar och falskt-positiv-finjustering
    ScreenVeritAI API
    Helt hanterat — listuppdateringar, modellförbättringar och infrastruktur sköts åt dig
    Revisionsspår
    Bygga internt
    Bygg din egen loggning, bevisgenerering och bevarandeinfrastruktur
    ScreenVeritAI API
    Tidsstämplade bevispaket med källreferenser och beslutsmotivering ingår

    §06Fyra steg till produktion

    p. 06 / 09
    1

    Hämta din API-nyckel

    Skapa en scoped API-nyckel från din ScreenVeritAI-instrumentpanel. Tilldela behörigheter — search:read, search:write, batch:read, batch:write — för åtkomst med minsta privilegium.

    2

    Integrera ändpunkten

    Lägg till ett enda POST-anrop i ditt onboarding-, betalnings- eller CRM-arbetsflöde. Skicka enhetsnamn, typ och land. API:et returnerar ett jobb-ID för asynkron hämtning av resultat.

    3

    Bearbeta resultat

    Polla resultatändpunkten eller ta emot en webhook-callback. Tolka det strukturerade JSON-svaret — sanktionsmatchningar, PEP-flaggor, negativa media-träffar och riskpoäng — och dirigera till din beslutslogik.

    4

    Övervaka och avisera

    Konfigurera löpande övervakning för granskade enheter. När sanktionslistor uppdateras eller ny negativ media dyker upp skickar API:et aviseringar så att ditt system kan utlösa omscreening automatiskt.

    §07Kom igång på minuter

    p. 07 / 09

    Ett enda API-anrop returnerar ett komplett screeningresultat.

    Granska en enhet
    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"}'
    Kontrollera resultat
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08API-prestanda

    p. 08 / 09

    Alla

    Stora källor granskade per API-anrop

    <2 min

    Genomsnittlig svarstid för en fullständig screening med djupforskning

    99.9%

    API-drifttids-SLA för produktionsintegrationer

    §09Vanliga frågor om API-integration

    p. 09 / 09
    01Hur autentiserar jag API-förfrågningar?
    Alla API-förfrågningar autentiseras med en API-nyckel som skickas i Authorization-headern. Nycklar skapas från din ScreenVeritAI-instrumentpanel med scoped behörigheter (search:read, search:write, batch:read, batch:write) för att tillämpa åtkomst med minsta privilegium.
    02Är API:et synkront eller asynkront?
    API:et använder en asynkron bearbetningsmodell. Du skickar in en screeningförfrågan via POST och får ett jobb-ID omedelbart. Resultat hämtas genom att polla resultatändpunkten eller genom att konfigurera en webhook-callback. Detta förhindrar blockering i din produktionspipeline medan AI-agenten slutför sin analys.
    03Vilket svarsformat returnerar API:et?
    Alla svar är strukturerad JSON med konsekventa fältnamn och typer. Screeningresultat inkluderar sanktionsmatchningsdetaljer, PEP-flaggor, negativa media-träffar, konfidenspoäng, källreferenser och risknivåklassificering — redo för automatiserad tolkning och beslutslogik utan manuell extraktion.
    04Vilka hastighetsbegränsningar gäller?
    Hastighetsbegränsningar tilldelas per prenumerationsnivå och tillämpas per API-nyckel. Svarsheaders inkluderar din aktuella gräns, kvarvarande kvot och tidsstämpel för återställning. Om du behöver högre genomströmning för massbearbetning accepterar batchändpunkten CSV/XLSX-uppladdningar för högvolymscreening.
    05Kan jag granska enheter i batch via API:et?
    Ja. Batchändpunkten accepterar CSV- eller XLSX-filer med upp till 100 rader per förfrågan. Varje rad bearbetas som en individuell screening och resultat kan hämtas per rad eller som en komplett nedladdningsbar export när jobbet slutförs.
    06Hur sätter jag upp löpande övervakning via API:et?
    Efter en inledande screening kan du konfigurera övervakning för den granskade enheten. När sanktionslistor uppdateras eller ny negativ media dyker upp skickar API:et en webhook-notifikation till din konfigurerade ändpunkt så att ditt system kan utlösa omscreening eller eskalering automatiskt.
    07Vilken compliancedata ingår i varje screeningresultat?
    Varje resultat inkluderar sanktionsmatchningar mot varje stor källa, PEP-status med familje- och närståendekopplingar, negativa media-träffar med flerspråkiga källhänvisningar, UBO-ägardata, risknivåklassificering och ett tidsstämplat bevispaket lämpligt för revision och regulatorisk granskning.
    08Hur lång tid tar en screening?
    En standardsanktionskontroll slutförs vanligtvis på sekunder. En djupforskningsscreening — inklusive negativ mediaanalys och ägarkartläggning — tar i genomsnitt under två minuter. Den asynkrona modellen innebär att ditt system aldrig blockeras i väntan på resultat.
    API-terminologi
    REST API
    En webb-API-arkitektur som använder standard HTTP-metoder (GET, POST, PUT, DELETE) för att interagera med resurser. ScreenVeritAI:s API följer REST-konventioner, vilket gör det kompatibelt med alla språk eller ramverk som kan göra HTTP-anrop.
    Webhook
    En server-till-server HTTP-callback som utlöses av en händelse. Istället för att polla efter resultat kan du konfigurera ScreenVeritAI att skicka en POST-förfrågan till din ändpunkt när en screening slutförs eller när löpande övervakning upptäcker en förändring.
    Asynkron bearbetning
    En förfråganmodell där API:et tar emot ett jobb omedelbart och bearbetar det i bakgrunden. Klienten får ett jobb-ID och hämtar resultat senare via polling eller webhook. Detta mönster förhindrar blockering i produktionspipelines.
    API-nyckel
    En hemlig token som används för att autentisera server-till-server API-förfrågningar. ScreenVeritAI:s API-nycklar har specifika behörigheter (search:read, search:write, batch:read, batch:write) för att tillämpa åtkomstmönster med minsta privilegium.
    Hastighetsbegränsning
    En mekanism som begränsar antalet API-förfrågningar en klient kan göra inom ett givet tidsfönster. Hastighetsbegränsningar tilldelas per prenumerationsnivå och kommuniceras via svarsheaders inklusive kvarvarande kvot och tidsstämpel för återställning.
    Strukturerat svar
    Ett maskinläsbart API-svarsformat (JSON) med konsekventa fältnamn, typer och nästling. Strukturerade svar möjliggör automatiserad tolkning, beslutslogik och generering av revisionsspår utan manuell dataextraktion.
    Branschkällor
    1. 01
    2. 02
      Regulatorisk teknik för AML/CFT-compliance

      Bank for International Settlements — FSI Insights

    3. 03
      OFAC:s ramverk för complianceåtaganden

      U.S. Department of the Treasury

    4. 04
      EU:s anti-penningtvättsmyndighet (AMLA) förordning

      Europeiska unionens officiella tidning

    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    Börja screena på minuter.

    Välj ett paket och börja screena redan idag.