ScreenVeritAI · API Specv1 · GA · reference
    Udvikler-API

    Hvorfor kopiere navne mellem systemer, når ét API-kald klarer det hele?

    Indbyg virksomhedsverifikation, ejerskabskortlægning, PEP-tjek, negativ omtale og sanktionssignaler direkte i dine eksisterende arbejdsgange.

    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

    Byg selv vs. integrér ScreenVeritAI

    p. 05 / 09
    Tid til produktion
    Byg selv
    6-12 måneder til at skaffe lister, bygge matchning og håndtere særtilfælde
    ScreenVeritAI API
    Dage til at integrere — produktionsklar fra første API-kald
    Dækning af sanktionslister
    Byg selv
    Manuel indlæsning af hvert listeformat; løbende skemavedligeholdelse
    ScreenVeritAI API
    Alle store kilder, vedligeholdt og opdateret løbende
    Matchningsnøjagtighed
    Byg selv
    Skræddersyet fuzzy matching kræver NLP-ekspertise og konstant finjustering
    ScreenVeritAI API
    AI med fuzzy matching, translitteration, aliasopløsning og fonetiske algoritmer
    PEP og negativ omtale
    Byg selv
    Separate leverandører, separate integrationer, separate budgetter
    ScreenVeritAI API
    PEP, negativ omtale og UBO-data i samme API-svar
    Løbende vedligeholdelse
    Byg selv
    Dedikeret team til listeopdateringer, skemaændringer og finjustering af falske positiver
    ScreenVeritAI API
    Fuldt administreret — opdateringer, forbedringer og infrastruktur håndteres for dig
    Revisionsspor
    Byg selv
    Byg din egen logning, dokumentation og opbevaringsinfrastruktur
    ScreenVeritAI API
    Tidsstemplede dokumentationspakker med kildehenvisninger inkluderet

    Fire trin til indbygget compliance

    p. 06 / 09
    1

    Få din API-nøgle

    Opret en afgrænset nøgle fra dit dashboard med minimumsrettigheder: search:read, search:write, batch:read, batch:write.

    2

    Integrér endpointet

    Ét POST-kald til dit onboarding-, betalings- eller CRM-flow — send enhedsnavn, type og land, og få et job-ID tilbage.

    3

    Behandl resultater

    Poll resultat-endpointet for struktureret JSON — virksomhedskontekst, ejerskab, PEP, negativ omtale, sanktionssignaler og risikoscorer.

    4

    Overvåg og alarmér

    Konfigurér løbende overvågning — API'et sender alarmer, når sanktionslister opdateres, eller ny negativ omtale dukker op.

    Kom i gang på få minutter

    p. 07 / 09

    Ét API-kald returnerer et komplet screeningresultat.

    Screen en enhed
    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 }
    Tjek 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-ydeevne

    p. 08 / 09

    €0.39

    Quick Check pr. kald, intet platformgebyr

    202

    HTTP-status når en søgning er accepteret; resultatet hentes derefter

    EU

    Hostet i Finland; data i hvile bliver i EU

    Ofte stillede spørgsmål om API-integration

    p. 09 / 09
    01Hvordan autentificerer jeg API-forespørgsler?
    Autentificer API-forespørgsler med en hemmelig nøgle sendt i X-API-Key-headeren. Nøgler oprettes fra dit dashboard med afgrænsede rettigheder.
    02Er API'et synkront eller asynkront?
    Asynkron. Send en anmodning, få et job-ID, hent resultater ved polling. Din pipeline blokeres aldrig.
    03Hvilket svarformat returnerer API'et?
    Struktureret JSON med sanktionsmatch, PEP-markeringer, negativ omtale, konfidensscorer, kildehenvisninger og risikoklassificering.
    04Hvilke rate limits gælder?
    Tildelt pr. abonnementsniveau pr. API-nøgle. Svarheaders indeholder resterende kvote og nulstillingstidspunkt.
    05Kan jeg screene enheder i batch via API'et?
    Ja. Batch-endpointet accepterer CSV eller XLSX med op til 100 rækker pr. forespørgsel, og resultater kan hentes pr. række eller som en samlet eksport.
    06Hvordan opsætter jeg løbende overvågning via API'et?
    Konfigurér overvågning efter den indledende screening. Når lister opdateres, eller ny negativ omtale dukker op, markerer overvågningen ændringen og advarer dig i appen.
    07Hvilke compliance-data er inkluderet i hvert screeningresultat?
    Sanktionsmatch på tværs af alle store kilder, PEP-status med familieforbindelser, negativ omtale med flersprogede kildehenvisninger, UBO-data, risikoklassificering og tidsstemplet dokumentationspakke.
    08Hvor lang tid tager en screening?
    Standard sanktionstjek: sekunder. Dybderesearch med negativ omtale og ejerskabskortlægning: under to minutter.
    API-terminologi
    REST API
    Web-API, der bruger standard HTTP-metoder — kompatibelt med ethvert sprog eller framework, der kan sende HTTP-forespørgsler.
    Asynkron behandling
    API'en accepterer et job med det samme og behandler det i baggrunden — hent resultater via polling.
    API-nøgle
    Hemmeligt token til autentificering af API-forespørgsler, afgrænset med specifikke rettigheder for minimumsadgang.
    Rate limiting
    Begrænser API-forespørgsler pr. tidsvindue efter abonnementsniveau — resterende kvote og nulstillingstidspunkt fremgår af svarheaders.
    Struktureret svar
    Maskinlæsbar JSON med konsistente feltnavne og -typer, der muliggør automatisk parsing og beslutningslogik.
    Branchekilder
    1. 01
    2. 02
      Regulatory Technology for AML/CFT Compliance

      Bank for International Settlements — FSI Insights

    3. 03
      OFAC Compliance Commitments Framework

      U.S. Department of the Treasury

    4. 04
      EU Anti-Money Laundering Authority (AMLA) Regulation

      Official Journal of the European Union

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

    End of API specification.

    Kom i gang med screening på få minutter.

    Vælg en plan, og start screeningen i dag.