API PEP și sancțiuni internaționale
Verificați persoane expuse public și sancțiuni internaționale direct din aplicația voastră: un apel REST, răspuns JSON, peste 470 de liste prin OpenSanctions.
Ce face API-ul PEP
Aplicația voastră trimite un nume, iar PepCheck îl caută în listele de sancțiuni și în registrele de persoane expuse public (PEP) și întoarce potrivirile găsite. Fiecare potrivire are un scor de similaritate, categoriile în care apare persoana (de exemplu funcție publică sau sancțiune), țările asociate și listele-sursă.
API-ul e gândit pentru entitățile raportoare din Legea nr. 129/2019 care vor screeningul PEP în propriul flux de lucru: IFN-uri, case de ajutor reciproc, contabili și auditori, agenții imobiliare, notari. În loc să copieze numele într-un site, verificarea se face la înrolarea clientului, din aplicația lor.
Un apel, un răspuns
curl -X POST https://pepcheck.ro/api/v1/pep/ \ -H "Authorization: Bearer pk_live_…" \ -H "Content-Type: application/json" \ -d '{"name": "Maria Ionescu", "type": "person", "birth_date": "1982-09-17", "nationality": "ro"}'
{
"query": "Maria Ionescu",
"type": "person",
"source": "OpenSanctions",
"result_status": "negative",
"risk_score": 0,
"total_matches": 0,
"matches": [],
"response_time_ms": 850
}
| Câmp din cerere | Obligatoriu | Ce face |
|---|---|---|
| name | Da | Numele căutat, minimum 3 caractere |
| type | Nu | person (implicit) sau company |
| birth_date, nationality | Nu | Pentru persoane: restrâng potrivirile și reduc omonimiile |
| jurisdiction, registration_number | Nu | Pentru firme: țara și numărul de înregistrare |
| Câmp din răspuns | Ce conține |
|---|---|
| result_status | negative (fără potriviri), partial (potriviri cu încredere scăzută) sau positive (potriviri găsite) |
| risk_score | Scor de risc de la 0 la 100 |
| matches[] | Pentru fiecare potrivire: name, score (similaritate), topics, countries, datasets, entity_id și fișa completă în data |
Construit pentru conformitate
- Pistă de audit. Fiecare apel intră în jurnalul organizației: endpointul, codul de răspuns, durata, adresa IP și aplicația care a făcut cererea. Îl puteți arăta la control.
- Temei legal declarat. Screeningul prelucrează date despre persoane fizice, de aceea organizația dă întâi declarația privind temeiul legal, ca și pentru căutările din interfață.
- Plătiți doar ce reușește. Creditele se scad numai la răspuns reușit: o eroare a sursei sau o cerere greșită nu consumă nimic.
- Limite clare. Fiecare cheie are o limită de cereri pe minut, implicit 10. La depășire primiți codul 429 cu antetul Retry-After.
- Surse. Peste 470 de liste prin OpenSanctions: sancțiuni ONU, UE, OFAC (SUA), OFSI (Regatul Unit), registre PEP.
Cum obțineți acces
Cheia API se generează din contul PepCheck, la Organizație → Chei API, și este disponibilă în pachetul Enterprise. Toate endpointurile, codurile de eroare și exemplele în Python și JavaScript sunt în documentația API.
Documentația API completă Întrebați-ne despre integrare
Întrebări frecvente
Ce este un API PEP?
Un API PEP permite unei aplicații să verifice automat dacă o persoană este persoană expusă public (PEP) sau figurează pe liste de sancțiuni internaționale. Aplicația trimite numele și primește înapoi potrivirile găsite, în format JSON.
Ce liste verifică API-ul PepCheck?
Peste 470 de liste de sancțiuni și de persoane expuse public, prin baza de date OpenSanctions: sancțiuni ONU, UE, OFAC (SUA), OFSI (Regatul Unit) și registre PEP.
Pot verifica și firme prin API?
Da. Câmpul type acceptă person (implicit) sau company. Pentru firme se pot trimite și țara și numărul de înregistrare. Pentru firmele românești, API-ul are și endpointuri pentru date ANAF, ONRC, MFP, dosare de instanță și scor de risc.
Cum obțin acces la API-ul PEP?
Cheia API se generează din contul PepCheck, la Organizație → Chei API. Accesul API este disponibil în pachetul Enterprise.
Rezultatul API-ului este o concluzie juridică?
Nu. O potrivire de nume nu confirmă singură identitatea persoanei. Evaluarea rezultatului și decizia aparțin entității raportoare și ofițerului său de conformitate.