Vývojárske API

Prečo prepisovať mená medzi systémami, keď to zvládne jedno volanie API?

Zabudujte overenie firiem, mapovanie vlastníctva, kontrolu PEP, negatívne médiá a sankčné signály priamo do svojich existujúcich procesov.

Získať API kľúč Zobraziť cenník

POST/api/v1/searchbash

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"
  }'
# 202 Accepted
# { "search_id": "SEARCH_ID", "status": "processing",
#   "estimated_time_seconds": 15 }

The request

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 context field; does not filter Quick Check matching
search_type"sanctions_check", "adverse_media" or "full_search"

The response

Structured JSON. Findings, not a score.

Core-jurisdiction fields and per-source arrays, plus criminal-watchlist and PEP/RCA findings. Review the available markdown, identifiers and source references; the response does not provide a numeric risk score.

GET/api/v1/search/{search_id}200 OK

{
  "id": "SEARCH_ID",
  "entity_name": "Acme Trading LLC",
  "entity_type": "company",
  "status": "completed",
  "search_type": "sanctions_check",
  "ofac_sanctions": "## OFAC Sanctions Findings\n\n**Status:** *Sanctioned*\n\n**Details:**\n- **Matched entity:** ACME TRADING LLC\n- **Authority:** US Treasury OFAC\n...",
  "eu_sanctions": "## EU Sanctions Findings\n\n**Status:** *No relevant listing found*\n...",
  "sanctions_sources": [
    { "source_id": "ofac_sanctions", "title": "OFAC Sanctions",
      "authority": "US Treasury OFAC", "hit_count": 1 },
    { "source_id": "eu_sanctions", "title": "EU Sanctions",
      "authority": "", "hit_count": 0 }
  ],
  "criminal_watchlists": null,
  "pep": null,
  "news_summary": null,
  "final_report": null,
  "created_at": "2026-09-04T09:20:03.771000+00:00",
  "completed_at": "2026-09-04T09:20:19.088000+00:00"
}

No relevant listing found / nullSanctioned / potential matchPer-source hit_countStatus and search_type

"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

Three calls cover a screening integration: queue it, poll it, or hand over a file.

POST/api/v1/searchQueue a screening run. Returns immediately with a search_id; the work happens in the background.202 Accepted

Requestbash

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"}'

Response202 Accepted

{ "search_id": "SEARCH_ID", "status": "processing",
  "message": "Search queued successfully. Poll the GET endpoint for results.",
  "estimated_time_seconds": 15 }

GET/api/v1/search/{search_id}Poll for the result. Terminal status is completed; failures land in an error_* status.200 OK

Requestbash

curl https://screenveritai.com/api/v1/search/SEARCH_ID \
  -H 'X-API-Key: YOUR_API_KEY'

Response200 OK

{ "id": "SEARCH_ID", "status": "completed", "search_type": "sanctions_check",
  "ofac_sanctions": "## OFAC Sanctions Findings ... *Sanctioned* ...",
  "eu_sanctions": "... *No relevant listing found* ...",
  "sanctions_sources": [{ "source_id": "ofac_sanctions", "hit_count": 1 }],
  "criminal_watchlists": null, "pep": null }

POST/api/v1/batchUpload a CSV or XLSX with a name column — up to 100 rows and 2 MB. Poll the job, then export the CSV.202 Accepted

Requestbash

curl -X POST https://screenveritai.com/api/v1/batch \
  -H 'X-API-Key: YOUR_API_KEY' \
  -F 'file=@portfolio.csv'

Response202 Accepted

{ "job_id": "JOB_ID", "total_rows": 100, "credits_charged": 100,
  "search_type": "sanctions_check", "status": "pending",
  "message": "Batch job created successfully. Poll the GET endpoint for status." }

Integration patterns

The API sits between data entry and decision — wherever you need a risk signal.

Customer onboarding
1. Customer signup
2. POST/api/v1/search
3. Poll until completed
4. Approve / hold
Payment processing
1. Transaction init
2. POST/api/v1/search
3. Poll until completed
4. Release / hold
CRM re-screen
1. Record updated
2. Your scheduler fires
3. POST/api/v1/search
4. Write result back

Vlastný vývoj vs. integrácia ScreenVeritAI

Vlastný vývoj vs. integrácia ScreenVeritAI
Aspekt	Vlastný vývoj	API ScreenVeritAI
Čas do produkcie	6 – 12 mesiacov na získanie zoznamov, vybudovanie porovnávania, riešenie hraničných prípadov	Dni na integráciu — pripravené na produkciu od prvého volania API
Pokrytie sankčných zoznamov	Ručné zapracovanie formátu každého zoznamu; priebežná údržba schém	Každý väčší zdroj, priebežne udržiavaný a aktualizovaný
Presnosť porovnávania	Vlastný fuzzy matching vyžaduje NLP odbornosť a neustále ladenie	AI s fuzzy matchingom, transliteráciou, rozpoznávaním aliasov a fonetickými algoritmami
PEP a negatívne médiá	Samostatní dodávatelia, samostatné integrácie, samostatné rozpočty	Dáta PEP, negatívnych médií a UBO v tej istej odpovedi API
Priebežná údržba	Vyhradený tím na aktualizácie zoznamov, zmeny schém, ladenie falošne pozitívnych výsledkov	Plne spravované — aktualizácie, vylepšenia aj infraštruktúru riešime za vás
Auditná stopa	Vybudujte si vlastnú infraštruktúru logovania, dôkazov a uchovávania záznamov	Časovo opečiatkované balíky dôkazov s odkazmi na zdroje zahrnuté od začiatku

Štyri kroky k vstavanému compliance

Získajte svoj API kľúč
Vytvorte si na nástenke kľúč s obmedzeným rozsahom oprávnení podľa princípu najmenších práv: search:read, search:write, batch:read, batch:write.
Integrujte endpoint
Jedno volanie POST z vášho onboardingového, platobného alebo CRM procesu — pošlete meno subjektu, typ a krajinu, dostanete späť ID úlohy.
Spracujte výsledky
Vyzdvihnite si výsledky pollingom endpointu ako štruktúrovaný JSON — kontext firmy, vlastníctvo, PEP, negatívne médiá, sankčné signály a rizikové skóre.
Monitorujte a upozorňujte
Nastavte priebežný monitoring — API pošle upozornenie, keď sa aktualizujú sankčné zoznamy alebo sa objavia nové negatívne médiá.

Začnite za pár minút

Jedno volanie API vráti kompletný výsledok screeningu.

Preverte subjektbash

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 }

Skontrolujte výsledokbash

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 }

Výkon API

€0.39
Quick Check za jedno volanie, bez poplatku za platformu
202
HTTP stav po prijatí vyhľadávania; výsledok sa potom dopytuje
EU
Hostované vo Fínsku; dáta v pokoji zostávajú v EÚ

Časté otázky k integrácii API

Ako autentifikujem požiadavky API?

Autentifikujte API požiadavky tajným kľúčom odovzdaným v hlavičke X-API-Key. Kľúče sa vytvárajú na vašej nástenke s obmedzeným rozsahom oprávnení.

Je API synchrónne alebo asynchrónne?

Asynchrónne. Odošlete požiadavku, dostanete ID úlohy, výsledky si vyzdvihnete pollingom. Váš proces sa nikdy neblokuje.

Aký formát odpovede API vracia?

Štruktúrovaný JSON s poľami hlavných jurisdikcií a poľami výsledkov jednotlivých zdrojov, doplnený o nálezy zo zoznamov hľadaných osôb a PEP/RCA. Prezrite dostupný markdown, identifikátory a odkazy na zdroje. Odpoveď neposkytuje číselné skóre rizika.

Aké limity požiadaviek platia?

Priradené podľa úrovne predplatného pre každý API kľúč. Hlavičky odpovede obsahujú zostávajúcu kvótu a čas resetu.

Môžem preveriť subjekty hromadne cez API?

Áno. Endpoint pre hromadné spracovanie prijíma CSV alebo XLSX s max. 100 riadkami na požiadavku, výsledky sú dostupné po riadkoch alebo ako kompletný export.

Ako nastavím priebežný monitoring cez API?

Monitoring nastavíte po úvodnom screeningu. Keď sa aktualizujú zoznamy alebo sa objavia nové negatívne médiá, monitoring označí zmenu a upozorní vás v aplikácii.

Aké compliance dáta sú súčasťou každého výsledku screeningu?

Sankčné zhody naprieč každým väčším zdrojom, PEP status s rodinnými väzbami, negatívne médiá s viacjazyčnými citáciami, dáta UBO, riziková úroveň a časovo opečiatkovaný balík dôkazov.

Ako dlho trvá screening?

Štandardná sankčná kontrola: sekundy. Deep Research s negatívnymi médiami a mapovaním vlastníctva: menej ako dve minúty.

Terminológia API

REST API: Webové API využívajúce štandardné HTTP metódy — kompatibilné s ľubovoľným jazykom alebo frameworkom, ktorý dokáže vykonávať HTTP požiadavky.
Asynchrónne spracovanie: API úlohu okamžite prijme a spracuje ju na pozadí — výsledky si vyzdvihnete pollingom.
API kľúč: Tajný token na autentifikáciu požiadaviek API, s obmedzeným rozsahom oprávnení podľa princípu najmenších práv.
Obmedzenie počtu požiadaviek (rate limiting): Obmedzuje počet požiadaviek API za časové okno podľa úrovne predplatného — zostávajúca kvóta a čas resetu sú v hlavičkách odpovede.
Štruktúrovaná odpoveď: Strojovo čitateľný JSON s konzistentnými názvami a typmi polí, ktorý umožňuje automatizované spracovanie a rozhodovaciu logiku.

Odborové zdroje

REST API pre AML screening

Integrujte screening sankcií, PEP, zoznamov hľadaných osôb, negatívnych médií a KYB/UBO priamo do svojich onboardingových, monitorovacích a transakčných procesov. API je živé: autentifikujte sa API kľúčom a volajte ten istý screeningový engine, aký používa portál.

Endpointy sú vo všeobecnej dostupnosti s autentifikáciou API kľúčom a limitmi požiadaviek podľa úrovne. Preskúmajte každý endpoint v interaktívnej OpenAPI dokumentácii na /api/v1/docs.

Quickstart API reference OpenAPI schema

Rýchly štart

1. Vytvorte API kľúč
Vytvorte si API kľúč s obmedzeným rozsahom oprávnení na svojej nástenke, alebo ho vygenerujte programovo pomocou bearer tokenu svojho účtu pre požiadavky medzi servermi.
POST/api/v1/keyscurl
```
curl -X POST https://screenveritai.com/api/v1/keys \
  -H "Authorization: Bearer <SUPABASE_JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name":"server-key","permissions":["search:read","search:write"]}'
```

2. Spustite prvé vyhľadávanie

Odošlite subjekt s hlavičkou X-API-Key. API vráti ID vyhľadávania, ktoré si vyzdvihnete po dokončení spracovania.

POST/api/v1/searchcurl

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 Ltd","entity_type":"company","search_type":"full_search"}'

3. Odošlite hromadnú úlohu
Pošlite súbor CSV/XLSX na preverenie mnohých subjektov v jednej úlohe a po dokončení hromadnej úlohy si vyzdvihnite riadky alebo export.
POST/api/v1/batchcurl
```
curl -X POST https://screenveritai.com/api/v1/batch \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -F "file=@entities.csv"
```

API reference (EN)OpenAPI schema

Hlavné endpointy

POST/api/v1/search
Vytvorí požiadavku na screening jedného subjektu. Vráti ID vyhľadávania a stav spracovania. Endpointy pre účet, pokrytie a stav sú tiež dostupné pod /api/v1.
Autentifikácia: X-API-Key (search:write)
POST/api/v1/batch
Odošlite súbory CSV/XLSX na screening vo veľkom objeme a po dokončení úloh si vyzdvihnite riadky alebo export.
Autentifikácia: X-API-Key (batch:write)
POST/api/v1/keys
Vytvárajte a spravujte API kľúče s obmedzeným rozsahom oprávnení, limitmi podľa úrovne a sledovaním využitia.
Autentifikácia: Bearer token (účet)

Crypto address checks. Source evidence at 0,39 €.

Check an address against OFAC’s published digital-currency identifiers. Add native-USDC issuer-block status on Ethereum in the same request, at the same price.

0,39 € per completed address check · prepaid PAYG only

POST/api/v1/crypto-address/checks
GET/api/v1/crypto-address/checks/{id}

API documentation (EN)

OFAC address match: Exact address lookup under the requested OFAC currency label, such as ETH, XBT, TRX, USDT or USDC. Evidence includes the publication date, source URL, export hash and matching OFAC record.
Ethereum USDC: Set network to ethereum to check native-USDC issuer-block status at a finalized Ethereum mainnet block. The result includes the contract address, block number, block hash and contract response. Omit network for an OFAC-only check.
Create a check: POST requires X-API-Key with search:write, an Idempotency-Key of 16–128 ASCII letters, digits, underscores, dots, colons or hyphens, and address, currency and integer max_prepaid_cents fields. Set max_prepaid_cents to 39 to authorize the current price. A completed request returns HTTP 200 synchronously.
Retrieve and retry: GET requires search:read and returns your saved check without another charge. If a POST response is lost, reuse the same Idempotency-Key and payload. Keep that key while the outcome is uncertain; create a new key only for a deliberate new check.
Billing: Completed checks debit 0,39 € from your EUR prepaid balance. Minimum balance top-up: €5. Subscription allowances do not apply. Source failures are unpaid.

A negative result means no published OFAC match or no native-USDC issuer block in the checked source. It does not establish wallet ownership or clear an address of all risk.

This is an address-level source check. Transaction tracing, exposure scoring and continuous KYT monitoring are outside its scope. Crypto checks use this separate API; they are not available through name-screening batch uploads, portal history or PDF reports.

Prečo tímy používajú toto API

Jedna integrácia pre screening sankcií, PEP, zoznamov hľadaných osôb, negatívnych médií a KYB/UBO
Autentifikácia API kľúčom cez hlavičku X-API-Key, s kľúčmi s obmedzeným rozsahom oprávnení podľa princípu najmenších práv
Limity požiadaviek podľa úrovne s logovaním využitia pre riadenie a kontrolu nákladov
Endpointy pre vyhľadávanie, hromadné spracovanie, kľúče, účet, pokrytie a stav pod /api/v1
Interaktívna OpenAPI dokumentácia na /api/v1/docs plus strojovo čitateľná OpenAPI schéma
Štruktúrovaný výstup vhodný pre auditné záznamy, spisy prípadov a nadväzujúce rozhodnutia

Integration playbooks

Developer guides
Endpoint contracts and worked examples for sanctions, PEP, criminal watchlists and batch screening.
PEP screening API guide
Implementation patterns for API-key auth, async jobs, and audit logs.
Batch screening workflow
Connect API and file-based flows for high-volume operations.
Workflow template
Map API responses into deterministic screening and escalation decisions.
Criminal watchlist coverage
See the official criminal and wanted-person lists included with sanctions and PEP checks.

Časté otázky k API

Ako autentifikujem požiadavky API?

Požiadavky na screening na /api/v1/search a /api/v1/batch sa autentifikujú API kľúčom odoslaným v hlavičke X-API-Key. Kľúče vytvoríte na svojej nástenke, alebo programovo cez /api/v1/keys po autentifikácii bearer tokenom svojho účtu.

Je API vo všeobecnej dostupnosti?

Áno. API v1 je live a vo všeobecnej dostupnosti. Autentifikujte sa API kľúčom, volajte endpointy pre vyhľadávanie, hromadné spracovanie a správu kľúčov a preskúmajte všetko v interaktívnej OpenAPI dokumentácii na /api/v1/docs.

Môžem obmedziť rozsah oprávnení API kľúča?

Áno. Kľúče podporujú oprávnenia ako search:read, search:write, batch:read a batch:write, takže môžete pre každú integráciu presadiť prístup podľa princípu najmenších práv.

Aké limity požiadaviek platia?

Limity sú priradené podľa úrovne API a vynucované pre každý API kľúč — úroveň určuje priepustnosť požiadaviek, nie fakturáciu. Hlavičky odpovede obsahujú limit, zostávajúcu kvótu a čas resetu, takže môžete plynulo spomaliť požiadavky.

Kde môžem rýchlo otestovať endpointy?

Použite interaktívnu dokumentáciu na /api/v1/docs na testovanie cez Swagger a /api/v1/redoc pre referenčnú dokumentáciu. OpenAPI schéma je dostupná na /api/v1/openapi.json.

Začnite screening za pár minút.

Vyberte si plán a začnite preverovať už dnes.

Získať API kľúč Zobraziť cenník

Prečo prepisovať mená medzi systémami, keď to zvládne jedno volanie API?

One POST call, then your poll loop.

Structured JSON. Findings, not a score.

API reference

Integration patterns

Customer onboarding

Payment processing

CRM re-screen

Vlastný vývoj vs. integrácia ScreenVeritAI

Štyri kroky k vstavanému compliance

Získajte svoj API kľúč

Integrujte endpoint

Spracujte výsledky

Monitorujte a upozorňujte

Začnite za pár minút

Výkon API

Časté otázky k integrácii API

Ako autentifikujem požiadavky API?

Je API synchrónne alebo asynchrónne?

Aký formát odpovede API vracia?

Aké limity požiadaviek platia?

Môžem preveriť subjekty hromadne cez API?

Ako nastavím priebežný monitoring cez API?

Aké compliance dáta sú súčasťou každého výsledku screeningu?

Ako dlho trvá screening?

Terminológia API

Odborové zdroje

Zistite viac

Screening sankcií

Screening klientov a hĺbková kontrola

Hromadný screening

Pokrytie sankčných zoznamov

REST API pre AML screening

Rýchly štart

1. Vytvorte API kľúč

2. Spustite prvé vyhľadávanie

3. Odošlite hromadnú úlohu

Hlavné endpointy

Crypto address checks. Source evidence at 0,39 €.

Prečo tímy používajú toto API

Integration playbooks

Developer guides

PEP screening API guide

Batch screening workflow

Workflow template

Criminal watchlist coverage

Časté otázky k API

Ako autentifikujem požiadavky API?

Je API vo všeobecnej dostupnosti?

Môžem obmedziť rozsah oprávnení API kľúča?

Aké limity požiadaviek platia?

Kde môžem rýchlo otestovať endpointy?

Začnite screening za pár minút.