API προγραμματιστών
Γιατί να αντιγράφετε ονόματα ανάμεσα σε συστήματα όταν μία κλήση API τα κάνει όλα;
Ενσωματώστε επαλήθευση εταιρειών, χαρτογράφηση ιδιοκτησίας, έλεγχο PEP, δυσμενή μέσα και σήματα κυρώσεων απευθείας στις υπάρχουσες ροές εργασίας σας.
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
Ανάπτυξη in-house έναντι ενσωμάτωσης ScreenVeritAI
| Πτυχή | Ανάπτυξη in-house | API ScreenVeritAI |
|---|---|---|
| Χρόνος έως παραγωγή | 6-12 μήνες για την προμήθεια λιστών, την κατασκευή αντιστοίχισης και τον χειρισμό ειδικών περιπτώσεων | Μέρες για ενσωμάτωση — έτοιμο για παραγωγή από την πρώτη κλήση API |
| Κάλυψη λιστών κυρώσεων | Χειροκίνητη εισαγωγή κάθε μορφής λίστας· συνεχής συντήρηση σχήματος | Κάθε σημαντική πηγή, συντηρούμενη και ενημερωμένη συνεχώς |
| Ακρίβεια αντιστοίχισης | Η προσαρμοσμένη ασαφής αντιστοίχιση απαιτεί εξειδίκευση NLP και συνεχή ρύθμιση | AI με ασαφή αντιστοίχιση, μεταγραμματισμό, επίλυση ψευδωνύμων και φωνητικούς αλγόριθμους |
| PEP και δυσμενή μέσα | Ξεχωριστοί πάροχοι, ξεχωριστές ενσωματώσεις, ξεχωριστοί προϋπολογισμοί | Δεδομένα PEP, δυσμενών μέσων και UBO στην ίδια απάντηση API |
| Συνεχής συντήρηση | Αφιερωμένη ομάδα για ενημερώσεις λιστών, αλλαγές σχήματος, ρύθμιση ψευδώς θετικών ευρημάτων | Πλήρως διαχειριζόμενο — ενημερώσεις, βελτιώσεις και υποδομή αναλαμβάνονται για εσάς |
| Ίχνος ελέγχου | Κατασκευάστε τη δική σας υποδομή καταγραφής, τεκμηρίωσης και διατήρησης | Φάκελοι αποδεικτικών στοιχείων με χρονοσήμανση και παραπομπές πηγών, ενσωματωμένοι |
Τέσσερα βήματα για ενσωματωμένη συμμόρφωση
Λάβετε το κλειδί API σας
Δημιουργήστε ένα κλειδί περιορισμένου εύρους από τον πίνακα ελέγχου σας με δικαιώματα ελάχιστου προνομίου: search:read, search:write, batch:read, batch:write.
Ενσωματώστε το endpoint
Μία κλήση POST στη ροή ένταξης, πληρωμών ή CRM σας — στείλτε όνομα οντότητας, τύπο και χώρα, λάβετε πίσω αναγνωριστικό εργασίας.
Επεξεργαστείτε τα αποτελέσματα
Κάντε polling στο endpoint αποτελεσμάτων για δομημένο JSON — εταιρικό πλαίσιο, ιδιοκτησία, PEP, δυσμενή μέσα, σήματα κυρώσεων και βαθμολογίες κινδύνου.
Παρακολουθήστε και ειδοποιηθείτε
Ρυθμίστε συνεχή παρακολούθηση — το API στέλνει ειδοποιήσεις όταν ενημερώνονται οι λίστες κυρώσεων ή αναδεικνύονται νέα δυσμενή μέσα.
Ξεκινήστε μέσα σε λίγα λεπτά
Μία κλήση API επιστρέφει ένα πλήρες αποτέλεσμα ελέγχου.
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
€0.39
Quick Check ανά κλήση, χωρίς χρέωση πλατφόρμας
202
Κατάσταση HTTP όταν γίνει δεκτή μια αναζήτηση· έπειτα ζητάτε το αποτέλεσμα
EU
Φιλοξενία στη Φινλανδία· τα δεδομένα σε ηρεμία παραμένουν στην ΕΕ
Συχνές ερωτήσεις για την ενσωμάτωση API
Πώς αυθεντικοποιώ τα αιτήματα API;
Αυθεντικοποιήστε τα αιτήματα API με ένα μυστικό κλειδί που μεταδίδεται στην κεφαλίδα X-API-Key. Τα κλειδιά δημιουργούνται από τον πίνακα ελέγχου σας με καθορισμένο εύρος δικαιωμάτων ελάχιστου προνομίου.
Είναι το API σύγχρονο ή ασύγχρονο;
Ασύγχρονο. Υποβάλλετε ένα αίτημα, λαμβάνετε ένα ID εργασίας και ανακτάτε τα αποτελέσματα με polling. Η ροή σας δεν μπλοκάρει ποτέ.
Ποια μορφή απάντησης επιστρέφει το API;
Δομημένο JSON με πεδία βασικών δικαιοδοσιών και πίνακες ανά πηγή, μαζί με ευρήματα καταζητούμενων και PEP/RCA. Εξετάστε το διαθέσιμο markdown, τα αναγνωριστικά και τις πηγές. Η απάντηση δεν παρέχει αριθμητική βαθμολογία κινδύνου.
Ποια όρια ρυθμού ισχύουν;
Καθορίζονται ανά πρόγραμμα συνδρομής και ανά κλειδί API. Οι κεφαλίδες απόκρισης περιλαμβάνουν το εναπομένον ποσοστό και τη χρονοσήμανση επαναφοράς.
Μπορώ να ελέγξω οντότητες μαζικά μέσω του API;
Ναι. Το endpoint μαζικού ελέγχου δέχεται CSV ή XLSX με έως 100 γραμμές ανά αίτημα, με αποτελέσματα ανακτήσιμα ανά γραμμή ή ως πλήρη εξαγωγή.
Πώς ρυθμίζω συνεχή παρακολούθηση μέσω του API;
Ρυθμίστε την παρακολούθηση μετά τον αρχικό έλεγχο. Όταν ενημερώνονται οι λίστες ή αναδεικνύονται νέα δυσμενή μέσα, η παρακολούθηση επισημαίνει την αλλαγή και σας ειδοποιεί εντός εφαρμογής.
Ποια δεδομένα συμμόρφωσης περιλαμβάνονται σε κάθε αποτέλεσμα ελέγχου;
Αντιστοιχίσεις κυρώσεων σε κάθε σημαντική πηγή, κατάσταση PEP με οικογενειακές συνδέσεις, δυσμενή μέσα με πολύγλωσσες παραπομπές, δεδομένα UBO, βαθμίδα κινδύνου και φάκελος αποδεικτικών στοιχείων με χρονοσήμανση.
Πόσο χρόνο διαρκεί ένας έλεγχος;
Τυπικός έλεγχος κυρώσεων: δευτερόλεπτα. Deep research με δυσμενή μέσα και χαρτογράφηση ιδιοκτησίας: κάτω από δύο λεπτά.
Ορολογία API
- REST API
- Web API που χρησιμοποιεί τυπικές μεθόδους HTTP — συμβατό με κάθε γλώσσα ή πλαίσιο που μπορεί να πραγματοποιεί αιτήματα HTTP.
- Ασύγχρονη επεξεργασία
- Το API δέχεται μια εργασία αμέσως και την επεξεργάζεται στο παρασκήνιο — ανακτήστε τα αποτελέσματα μέσω polling.
- Κλειδί API
- Μυστικό διακριτικό για την αυθεντικοποίηση αιτημάτων API, με καθορισμένο εύρος δικαιωμάτων για πρόσβαση ελάχιστου προνομίου.
- Περιορισμός ρυθμού
- Περιορίζει τα αιτήματα API ανά χρονικό παράθυρο βάσει προγράμματος συνδρομής — το εναπομένον ποσοστό και η χρονοσήμανση επαναφοράς εμφανίζονται στις κεφαλίδες απόκρισης.
- Δομημένη απάντηση
- Αναγνώσιμο από μηχανή JSON με συνεπή ονόματα και τύπους πεδίων, που επιτρέπει αυτοματοποιημένη ανάλυση και λογική αποφάσεων.
REST API για έλεγχο AML
Ενσωματώστε τον έλεγχο κυρώσεων, PEP, ποινικής παρακολούθησης, δυσμενών μέσων και KYB/UBO απευθείας στις ροές ένταξης πελατών, παρακολούθησης και συναλλαγών σας. Το API είναι ζωντανό: αυθεντικοποιηθείτε με κλειδί API και καλέστε την ίδια μηχανή ελέγχου που χρησιμοποιεί η πλατφόρμα.
Τα endpoints είναι γενικά διαθέσιμα με αυθεντικοποίηση μέσω κλειδιού API και όρια ρυθμού ανά πρόγραμμα. Εξερευνήστε κάθε endpoint στη διαδραστική τεκμηρίωση OpenAPI στο /api/v1/docs.
Γρήγορη εκκίνηση
1. Δημιουργήστε κλειδί API
Δημιουργήστε ένα κλειδί API με καθορισμένο εύρος δικαιωμάτων από τον πίνακα ελέγχου σας, ή δημιουργήστε ένα προγραμματιστικά με το bearer token του λογαριασμού σας για αιτήματα διακομιστή προς διακομιστή.
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. Εκτελέστε την πρώτη σας αναζήτηση
Υποβάλετε μια οντότητα με την κεφαλίδα X-API-Key. Το API επιστρέφει ένα αναγνωριστικό αναζήτησης που ανακτάτε όταν ολοκληρωθεί η επεξεργασία.
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. Υποβάλετε μαζική εργασία
Στείλτε ένα αρχείο CSV/XLSX για να ελέγξετε πολλές οντότητες σε μία εργασία, και ανακτήστε γραμμές ή εξαγωγές μόλις ολοκληρωθεί η μαζική εργασία.
POST/api/v1/batch curl -X POST https://screenveritai.com/api/v1/batch \ -H "X-API-Key: <YOUR_API_KEY>" \ -F "file=@entities.csv"
Βασικά endpoints
- POST
/api/v1/searchΔημιουργεί αίτημα ελέγχου για μία οντότητα. Επιστρέφει αναγνωριστικό αναζήτησης και κατάσταση επεξεργασίας. Διατίθενται επίσης endpoints λογαριασμού, κάλυψης και κατάστασης λειτουργίας κάτω από το /api/v1.
Αυθεντικοποίηση: X-API-Key (search:write)
- POST
/api/v1/batchΥποβάλετε αρχεία CSV/XLSX για έλεγχο μεγάλου όγκου, και ανακτήστε γραμμές ή εξαγωγές όταν ολοκληρωθούν οι εργασίες.
Αυθεντικοποίηση: X-API-Key (batch:write)
- POST
/api/v1/keysΔημιουργήστε και διαχειριστείτε διαπιστευτήρια API με καθορισμένο εύρος δικαιωμάτων, όρια ρυθμού ανά πρόγραμμα και παρακολούθηση χρήσης.
Αυθεντικοποίηση: Bearer token (λογαριασμός)
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.
Γιατί οι ομάδες χρησιμοποιούν το API
- Μία ενσωμάτωση για έλεγχο κυρώσεων, PEP, ποινικής παρακολούθησης, δυσμενών μέσων και KYB/UBO
- Αυθεντικοποίηση μέσω κλειδιού API με την κεφαλίδα X-API-Key, με κλειδιά περιορισμένων δικαιωμάτων για πρόσβαση ελάχιστου προνομίου
- Όρια ρυθμού ανά πρόγραμμα με καταγραφή χρήσης για διακυβέρνηση και έλεγχο κόστους
- Endpoints αναζήτησης, μαζικού ελέγχου, κλειδιών, λογαριασμού, κάλυψης και κατάστασης λειτουργίας κάτω από το /api/v1
- Διαδραστική τεκμηρίωση OpenAPI στο /api/v1/docs, μαζί με αναγνώσιμο από μηχανή σχήμα OpenAPI
- Δομημένη έξοδος κατάλληλη για αρχεία ελέγχου, φακέλους υποθέσεων και αποφάσεις επόμενου σταδίου
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
Πώς αυθεντικοποιώ τα αιτήματα API;
Τα αιτήματα ελέγχου προς /api/v1/search και /api/v1/batch αυθεντικοποιούνται με κλειδί API που στέλνεται στην κεφαλίδα X-API-Key. Δημιουργήστε κλειδιά από τον πίνακα ελέγχου σας, ή προγραμματιστικά μέσω του /api/v1/keys αφού αυθεντικοποιηθείτε με το bearer token του λογαριασμού σας.
Είναι το API γενικά διαθέσιμο;
Ναι. Το API v1 είναι ζωντανό και γενικά διαθέσιμο. Αυθεντικοποιηθείτε με κλειδί API, καλέστε τα endpoints αναζήτησης, μαζικού ελέγχου και διαχείρισης κλειδιών, και εξερευνήστε τα όλα στη διαδραστική τεκμηρίωση OpenAPI στο /api/v1/docs.
Μπορώ να περιορίσω τα δικαιώματα ενός κλειδιού API;
Ναι. Τα κλειδιά υποστηρίζουν δικαιώματα όπως search:read, search:write, batch:read και batch:write, ώστε να επιβάλλετε πρόσβαση ελάχιστου προνομίου ανά ενσωμάτωση.
Ποια όρια ρυθμού ισχύουν;
Τα όρια ρυθμού καθορίζονται ανά επίπεδο API και επιβάλλονται ανά κλειδί API — το επίπεδο διέπει τη ροή αιτημάτων, όχι τη χρέωση. Οι κεφαλίδες απόκρισης περιλαμβάνουν το όριο, το εναπομένον ποσοστό και τη χρονοσήμανση επαναφοράς, ώστε να μπορείτε να προσαρμόσετε τον ρυθμό των αιτημάτων σας ομαλά.
Πού μπορώ να δοκιμάσω γρήγορα τα endpoints;
Χρησιμοποιήστε τη διαδραστική τεκμηρίωση στο /api/v1/docs για δοκιμές Swagger και το /api/v1/redoc για τεκμηρίωση τύπου αναφοράς. Το σχήμα OpenAPI εξυπηρετείται στο /api/v1/openapi.json.
Ξεκινήστε τον έλεγχο σε λίγα λεπτά.
Επιλέξτε πρόγραμμα και ξεκινήστε τον έλεγχο σήμερα.