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.
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 matchingentity_type"person", "company" or "any" (default "any")countryOptional context field; does not filter Quick Check matchingsearch_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.
{
"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"
}"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
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"}'{ "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
curl https://screenveritai.com/api/v1/search/SEARCH_ID \
-H 'X-API-Key: YOUR_API_KEY'{ "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
curl -X POST https://screenveritai.com/api/v1/batch \
-H 'X-API-Key: YOUR_API_KEY' \
-F 'file=@portfolio.csv'{ "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
- Customer signup
- POST
/api/v1/search - Poll until completed
- Approve / hold
Payment processing
- Transaction init
- POST
/api/v1/search - Poll until completed
- Release / hold
CRM re-screen
- Record updated
- Your scheduler fires
- POST
/api/v1/search - Write result back
Kurti savoje sistemoje ar integruoti ScreenVeritAI
| Aspektas | Kurti savoje sistemoje | ScreenVeritAI API |
|---|---|---|
| Laikas iki gamybos | 6–12 mėnesių sąrašams surinkti, atitikimui sukurti ir kraštiniams atvejams apdoroti | Kelios dienos integracijai — paruošta gamybai nuo pirmos API užklausos |
| Sankcijų sąrašų aprėptis | Rankinis kiekvieno sąrašo formato įkėlimas; nuolatinė schemų priežiūra | Kiekvienas pagrindinis šaltinis, nuolat prižiūrimas ir atnaujinamas |
| Atitikimo tikslumas | Individualus apytikslis atitikimas reikalauja NLP kompetencijos ir nuolatinio derinimo | DI su apytiksliu atitikimu, transliteracija, alternatyvių vardų atpažinimu ir fonetiniais algoritmais |
| PEP ir neigiama žiniasklaida | Atskiri tiekėjai, atskiros integracijos, atskiri biudžetai | PEP, neigiamos žiniasklaidos ir UBO duomenys tame pačiame API atsakyme |
| Nuolatinė priežiūra | Speciali komanda sąrašų atnaujinimams, schemų pokyčiams ir klaidingų atitikmenų derinimui | Visiškai valdoma — atnaujinimai, patobulinimai ir infrastruktūra tvarkomi už jus |
| Audito seka | Kurkite savo registravimo, įrodymų ir saugojimo infrastruktūrą | Laiko žyma pažymėti įrodymų paketai su šaltinių nuorodomis |
Keturi žingsniai iki integruotos atitikties
Gaukite API raktą
Valdymo skydelyje sukurkite apribotų teisių raktą su mažiausios privilegijos teisėmis: search:read, search:write, batch:read, batch:write.
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.
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.
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
Viena API užklausa grąžina visą patikros rezultatą.
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 }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
€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
Kaip 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.
API sinchroninis ar asinchroninis?
Asinchroninis. Pateikiate užklausą, gaunate užduoties ID, o rezultatus atsiimate apklausos būdu. Jūsų procesas niekada neblokuojamas.
Kokį atsakymo formatą grąžina API?
Struktūrizuotas JSON su pagrindinių jurisdikcijų laukais ir kiekvieno šaltinio masyvais bei ieškomų asmenų sąrašų ir PEP/RCA rezultatais. Peržiūrėkite turimą markdown, identifikatorius ir šaltinių nuorodas. Atsakyme nėra skaitinio rizikos balo.
Kokios užklausų ribos taikomos?
Priskiriamos pagal prenumeratos pakopą kiekvienam API raktui. Atsakymo antraštėse pateikiama likusi kvota ir atkūrimo laiko žyma.
Ar 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ą.
Kaip 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.
Kokie 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.
Kiek 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ą.
REST API AML patikrai
Integruokite sankcijų, PEP, kriminalinių sąrašų, neigiamos žiniasklaidos (angl. „adverse media“) ir KYB/UBO patikrą tiesiai į kliento priėmimo, stebėsenos ir sandorių eigas. API jau veikia: autentifikuokitės API raktu ir kvieskite tą patį patikros variklį, kurį naudoja portalas.
Galiniai taškai yra visuotinai prieinami su API rakto autentifikacija ir pakopinėmis užklausų ribomis. Kiekvieną galinį tašką išbandykite interaktyvioje OpenAPI dokumentacijoje adresu /api/v1/docs.
Greita pradžia
1. Sukurkite API raktą
Sukurkite apribotų teisių API raktą valdymo skydelyje arba sugeneruokite jį programiškai su paskyros bearer žetonu serveris–serveris užklausoms.
POST/api/v1/keys 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. Atlikite pirmą paiešką
Pateikite subjektą su X-API-Key antrašte. API grąžina paieškos ID, kurį atsiimate, kai apdorojimas baigiamas.
POST/api/v1/search 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. Pateikite masinę užduotį
Nusiųskite CSV/XLSX failą, kad viena užduotimi patikrintumėte daug subjektų, o pasibaigus masinei patikrai atsiimkite eilutes ar eksportą.
POST/api/v1/batch curl -X POST https://screenveritai.com/api/v1/batch \ -H "X-API-Key: <YOUR_API_KEY>" \ -F "file=@entities.csv"
Pagrindiniai galiniai taškai
- POST
/api/v1/searchSukuria vieno subjekto patikros užklausą. Grąžina paieškos ID ir apdorojimo būseną. Paskyros, aprėpties ir būklės galiniai taškai taip pat pasiekiami po /api/v1.
Autentifikacija: X-API-Key (search:write)
- POST
/api/v1/batchPateikite CSV/XLSX failus didelės apimties patikrai, o pasibaigus užduotims atsiimkite eilutes ar eksportą.
Autentifikacija: X-API-Key (batch:write)
- POST
/api/v1/keysKurkite ir tvarkykite API prisijungimo duomenis su apribotomis teisėmis, pagal pakopą taikomomis užklausų ribomis ir naudojimo stebėjimu.
Autentifikacija: Bearer žetonas (paskyra)
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}
- 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.
Kodėl komandos renkasi API
- Viena integracija sankcijų, PEP, kriminalinių sąrašų, neigiamos žiniasklaidos ir KYB/UBO patikrai
- API rakto autentifikacija per X-API-Key antraštę su teisėmis apribotais raktais mažiausios privilegijos prieigai
- Pagal pakopą taikomos užklausų ribos su naudojimo registravimu valdysenai ir išlaidų kontrolei
- Paieškos, masinės patikros, raktų, paskyros, aprėpties ir būklės galiniai taškai po /api/v1
- Interaktyvi OpenAPI dokumentacija adresu /api/v1/docs ir mašininiu būdu nuskaitoma OpenAPI schema
- Struktūrizuota išvestis, tinkama audito žurnalams, bylų dokumentacijai ir tolesniems sprendimams
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.
API DUK
Kaip autentifikuoti API užklausas?
Patikros užklausos į /api/v1/search ir /api/v1/batch autentifikuojamos API raktu, siunčiamu X-API-Key antraštėje. Raktus kurkite valdymo skydelyje arba programiškai per /api/v1/keys, prieš tai autentifikavęsi paskyros bearer žetonu.
Ar API yra visuotinai prieinamas?
Taip. API v1 jau veikia ir yra visuotinai prieinamas. Autentifikuokitės API raktu, kvieskite paieškos, masinės patikros ir raktų valdymo galinius taškus bei viską išbandykite interaktyvioje OpenAPI dokumentacijoje adresu /api/v1/docs.
Ar galiu apriboti API rakto teises?
Taip. Raktai palaiko tokias teises kaip search:read, search:write, batch:read ir batch:write, kad galėtumėte kiekvienai integracijai užtikrinti mažiausios privilegijos prieigą.
Kokios užklausų ribos taikomos?
Užklausų ribos priskiriamos pagal API pakopą ir taikomos kiekvienam API raktui — pakopa nustato užklausų pralaidumą, o ne apmokestinimą. Atsakymo antraštėse pateikiama riba, likusi kvota ir atkūrimo laiko žymos, kad galėtumėte tvarkingai sulėtinti užklausas.
Kur galiu greitai išbandyti galinius taškus?
Naudokitės interaktyvia dokumentacija adresu /api/v1/docs (Swagger bandymams) ir /api/v1/redoc (žinyno tipo dokumentacija). OpenAPI schema pateikiama adresu /api/v1/openapi.json.
Pradėkite patikrą per kelias minutes.
Pasirinkite planą ir pradėkite tikrinti jau šiandien.