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

    Hämta API-nyckelVisa priser

    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

    Bygga 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

    Fyra 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 för strukturerad JSON — företagskontext, ägande, PEP, negativ media, sanktionssignaler och riskpoäng.

    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.

    Kom igång på minuter

    p. 07 / 09

    Ett enda API-anrop returnerar ett komplett screeningresultat.

    Granska en enhet
    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 }
    Kontrollera resultat
    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-prestanda

    p. 08 / 09

    €0.39

    Quick Check per anrop, ingen plattformsavgift

    202

    HTTP-status när en sökning accepterats; resultatet hämtas sedan

    EU

    Driftas i Finland; lagrad data stannar i EU

    Vanliga 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 X-API-Key-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?
    Asynkront. Skicka in en förfrågan, få ett jobb-ID, hämta resultaten genom polling. Din pipeline blockerar aldrig.
    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?
    Konfigurera övervakning efter en inledande screening. När listor uppdateras eller ny negativ media dyker upp flaggar övervakningen förändringen och aviserar dig i appen.
    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.
    Asynkron bearbetning
    API:et tar emot ett jobb direkt och bearbetar det i bakgrunden — hämta resultaten genom polling.
    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

    Utforska mer

    Sanktionsscreening

    Granska entiteter mot varje stor källa med fuzzy matching och tillsynskvalitativ bevisning.

    Kundscreening och due diligence

    Gå bortom sanktionslistor — kartlägg ägande, PEP-exponering och negativ media för fullständiga riskprofiler.

    Batchscreening

    Ladda upp CSV- eller XLSX-filer och granska hundratals enheter mot alla sanktionsregimer i ett enda jobb.

    Sanktionslisttäckning

    Se varje sanktionslista, PEP-databas och jurisdiktion som ScreenVeritAI täcker.

    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.

    Se priser