ScreenVeritAI · API Specv1 · GA · reference
    API προγραμματιστών

    Γιατί να αντιγράφετε ονόματα ανάμεσα σε συστήματα όταν μία κλήση API τα κάνει όλα;

    Ενσωματώστε επαλήθευση εταιρειών, χαρτογράφηση ιδιοκτησίας, έλεγχο PEP, δυσμενή μέσα και σήματα κυρώσεων απευθείας στις υπάρχουσες ροές εργασίας σας.

    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

    Ανάπτυξη in-house έναντι ενσωμάτωσης ScreenVeritAI

    p. 05 / 09
    Χρόνος έως παραγωγή
    Ανάπτυξη in-house
    6-12 μήνες για την προμήθεια λιστών, την κατασκευή αντιστοίχισης και τον χειρισμό ειδικών περιπτώσεων
    API ScreenVeritAI
    Μέρες για ενσωμάτωση — έτοιμο για παραγωγή από την πρώτη κλήση API
    Κάλυψη λιστών κυρώσεων
    Ανάπτυξη in-house
    Χειροκίνητη εισαγωγή κάθε μορφής λίστας· συνεχής συντήρηση σχήματος
    API ScreenVeritAI
    Κάθε σημαντική πηγή, συντηρούμενη και ενημερωμένη συνεχώς
    Ακρίβεια αντιστοίχισης
    Ανάπτυξη in-house
    Η προσαρμοσμένη ασαφής αντιστοίχιση απαιτεί εξειδίκευση NLP και συνεχή ρύθμιση
    API ScreenVeritAI
    AI με ασαφή αντιστοίχιση, μεταγραμματισμό, επίλυση ψευδωνύμων και φωνητικούς αλγόριθμους
    PEP και δυσμενή μέσα
    Ανάπτυξη in-house
    Ξεχωριστοί πάροχοι, ξεχωριστές ενσωματώσεις, ξεχωριστοί προϋπολογισμοί
    API ScreenVeritAI
    Δεδομένα PEP, δυσμενών μέσων και UBO στην ίδια απάντηση API
    Συνεχής συντήρηση
    Ανάπτυξη in-house
    Αφιερωμένη ομάδα για ενημερώσεις λιστών, αλλαγές σχήματος, ρύθμιση ψευδώς θετικών ευρημάτων
    API ScreenVeritAI
    Πλήρως διαχειριζόμενο — ενημερώσεις, βελτιώσεις και υποδομή αναλαμβάνονται για εσάς
    Ίχνος ελέγχου
    Ανάπτυξη in-house
    Κατασκευάστε τη δική σας υποδομή καταγραφής, τεκμηρίωσης και διατήρησης
    API ScreenVeritAI
    Φάκελοι αποδεικτικών στοιχείων με χρονοσήμανση και παραπομπές πηγών, ενσωματωμένοι

    Τέσσερα βήματα για ενσωματωμένη συμμόρφωση

    p. 06 / 09
    1

    Λάβετε το κλειδί API σας

    Δημιουργήστε ένα κλειδί περιορισμένου εύρους από τον πίνακα ελέγχου σας με δικαιώματα ελάχιστου προνομίου: search:read, search:write, batch:read, batch:write.

    2

    Ενσωματώστε το endpoint

    Μία κλήση POST στη ροή ένταξης, πληρωμών ή CRM σας — στείλτε όνομα οντότητας, τύπο και χώρα, λάβετε πίσω αναγνωριστικό εργασίας.

    3

    Επεξεργαστείτε τα αποτελέσματα

    Κάντε polling στο endpoint αποτελεσμάτων για δομημένο JSON — εταιρικό πλαίσιο, ιδιοκτησία, PEP, δυσμενή μέσα, σήματα κυρώσεων και βαθμολογίες κινδύνου.

    4

    Παρακολουθήστε και ειδοποιηθείτε

    Ρυθμίστε συνεχή παρακολούθηση — το API στέλνει ειδοποιήσεις όταν ενημερώνονται οι λίστες κυρώσεων ή αναδεικνύονται νέα δυσμενή μέσα.

    Ξεκινήστε μέσα σε λίγα λεπτά

    p. 07 / 09

    Μία κλήση API επιστρέφει ένα πλήρες αποτέλεσμα ελέγχου.

    Ελέγξτε μια οντότητα
    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 }
    Ελέγξτε το αποτέλεσμα
    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

    p. 08 / 09

    €0.39

    Quick Check ανά κλήση, χωρίς χρέωση πλατφόρμας

    202

    Κατάσταση HTTP όταν γίνει δεκτή μια αναζήτηση· έπειτα ζητάτε το αποτέλεσμα

    EU

    Φιλοξενία στη Φινλανδία· τα δεδομένα σε ηρεμία παραμένουν στην ΕΕ

    Συχνές ερωτήσεις για την ενσωμάτωση API

    p. 09 / 09
    01Πώς αυθεντικοποιώ τα αιτήματα API;
    Αυθεντικοποιήστε τα αιτήματα API με ένα μυστικό κλειδί που μεταδίδεται στην κεφαλίδα X-API-Key. Τα κλειδιά δημιουργούνται από τον πίνακα ελέγχου σας με καθορισμένο εύρος δικαιωμάτων ελάχιστου προνομίου.
    02Είναι το API σύγχρονο ή ασύγχρονο;
    Ασύγχρονο. Υποβάλλετε ένα αίτημα, λαμβάνετε ένα ID εργασίας και ανακτάτε τα αποτελέσματα με polling. Η ροή σας δεν μπλοκάρει ποτέ.
    03Ποια μορφή απάντησης επιστρέφει το API;
    Δομημένο JSON με αντιστοιχίσεις κυρώσεων, σημάνσεις PEP, δυσμενή μέσα, βαθμούς εμπιστοσύνης, παραπομπές πηγών και κατάταξη κατά βαθμίδα κινδύνου.
    04Ποια όρια ρυθμού ισχύουν;
    Καθορίζονται ανά πρόγραμμα συνδρομής και ανά κλειδί API. Οι κεφαλίδες απόκρισης περιλαμβάνουν το εναπομένον ποσοστό και τη χρονοσήμανση επαναφοράς.
    05Μπορώ να ελέγξω οντότητες μαζικά μέσω του API;
    Ναι. Το endpoint μαζικού ελέγχου δέχεται CSV ή XLSX με έως 100 γραμμές ανά αίτημα, με αποτελέσματα ανακτήσιμα ανά γραμμή ή ως πλήρη εξαγωγή.
    06Πώς ρυθμίζω συνεχή παρακολούθηση μέσω του API;
    Ρυθμίστε την παρακολούθηση μετά τον αρχικό έλεγχο. Όταν ενημερώνονται οι λίστες ή αναδεικνύονται νέα δυσμενή μέσα, η παρακολούθηση επισημαίνει την αλλαγή και σας ειδοποιεί εντός εφαρμογής.
    07Ποια δεδομένα συμμόρφωσης περιλαμβάνονται σε κάθε αποτέλεσμα ελέγχου;
    Αντιστοιχίσεις κυρώσεων σε κάθε σημαντική πηγή, κατάσταση PEP με οικογενειακές συνδέσεις, δυσμενή μέσα με πολύγλωσσες παραπομπές, δεδομένα UBO, βαθμίδα κινδύνου και φάκελος αποδεικτικών στοιχείων με χρονοσήμανση.
    08Πόσο χρόνο διαρκεί ένας έλεγχος;
    Τυπικός έλεγχος κυρώσεων: δευτερόλεπτα. Deep research με δυσμενή μέσα και χαρτογράφηση ιδιοκτησίας: κάτω από δύο λεπτά.
    Ορολογία API
    REST API
    Web API που χρησιμοποιεί τυπικές μεθόδους HTTP — συμβατό με κάθε γλώσσα ή πλαίσιο που μπορεί να πραγματοποιεί αιτήματα HTTP.
    Ασύγχρονη επεξεργασία
    Το API δέχεται μια εργασία αμέσως και την επεξεργάζεται στο παρασκήνιο — ανακτήστε τα αποτελέσματα μέσω polling.
    Κλειδί API
    Μυστικό διακριτικό για την αυθεντικοποίηση αιτημάτων API, με καθορισμένο εύρος δικαιωμάτων για πρόσβαση ελάχιστου προνομίου.
    Περιορισμός ρυθμού
    Περιορίζει τα αιτήματα API ανά χρονικό παράθυρο βάσει προγράμματος συνδρομής — το εναπομένον ποσοστό και η χρονοσήμανση επαναφοράς εμφανίζονται στις κεφαλίδες απόκρισης.
    Δομημένη απάντηση
    Αναγνώσιμο από μηχανή JSON με συνεπή ονόματα και τύπους πεδίων, που επιτρέπει αυτοματοποιημένη ανάλυση και λογική αποφάσεων.
    Πηγές του κλάδου
    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.

    Ξεκινήστε τον έλεγχο σε λίγα λεπτά.

    Επιλέξτε πρόγραμμα και ξεκινήστε τον έλεγχο σήμερα.