REST API

PEPCheck
API v1

Integrati serviciile PEPCheck direct in aplicatia dumneavoastra. Date reale, actualizate zilnic, dintr-un singur API.

Exploreaza Endpoint-urile Autentificare
Autentificare Endpoint-uri Coduri Eroare Rate Limiting Credite

Autentificare

Toate request-urile catre API necesita un token Bearer valid. Cheia API se genereaza din contul Enterprise, sectiunea Setari → Chei API.

Header de autentificare

Includeti cheia API in header-ul Authorization al fiecarui request:

// Header obligatoriu Authorization: Bearer pk_live_aBcDeFgHiJkLmNoPqRsT...

Base URL

https://new.pepcheck.ro/api/v1/

Toate endpoint-urile sunt relative la acest URL de baza. Se accepta doar HTTPS.

Endpoint-uri

Fiecare endpoint returneaza JSON si include campul response_time_ms pentru monitorizare.

GET /api/v1/status/ 0 credite

Status cont, credite ramase si informatii despre cheia API curenta.

# Verificare status cont curl -X GET https://new.pepcheck.ro/api/v1/status/ \ -H "Authorization: Bearer pk_live_aBcDeFg..."

Raspuns exemplu

{ "organization": "Firma SRL", "package": "enterprise", "credits_used": 45, "credits_limit": 750, "credits_remaining": 705, "api_key_name": "Production", "rate_limit_per_minute": 10 }
GET /api/v1/anaf/{cui}/ 1 credit

Date fiscale ANAF in timp real: stare inregistrare, TVA, e-Factura, adresa sediu social.

Parametri

Parametru Tip Obligatoriu Descriere
cui path Da Codul Unic de Inregistrare al firmei
# Date fiscale ANAF pentru CUI 12345678 curl -X GET https://new.pepcheck.ro/api/v1/anaf/12345678/ \ -H "Authorization: Bearer pk_live_aBcDeFg..."

Raspuns exemplu

{ "cui": "12345678", "source": "ANAF", "data": { "date_generale": { "denumire": "EXEMPLU SRL", "stare_inregistrare": "INREGISTRAT din data 01.01.2015", "statusRO_e_Factura": true }, "inregistrare_scop_Tva": { "scpTVA": true } }, "response_time_ms": 230 }
GET /api/v1/mfp/{cui}/ 1 credit

Bilanturi MFP (Ministerul Finantelor) din data.gov.ro: cifra de afaceri, profit net, numar salariati.

Parametri

Parametru Tip Obligatoriu Descriere
cui path Da Codul Unic de Inregistrare al firmei
# Bilanturi MFP pentru CUI 12345678 curl -X GET https://new.pepcheck.ro/api/v1/mfp/12345678/ \ -H "Authorization: Bearer pk_live_aBcDeFg..."

Raspuns exemplu

{ "cui": "12345678", "source": "MFP (data.gov.ro)", "years_available": 3, "data": [ { "year": 2023, "cifra_de_afaceri": 1500000, "profit_net": 250000, "numar_mediu_salariati": 12 } ], "response_time_ms": 45 }
GET /api/v1/onrc/{cui}/ 1 credit

Registrul Comertului (ONRC) din data.gov.ro: date inmatriculare, status, administratori, asociati.

Parametri

Parametru Tip Obligatoriu Descriere
cui path Da Codul Unic de Inregistrare al firmei
# Date ONRC pentru CUI 12345678 curl -X GET https://new.pepcheck.ro/api/v1/onrc/12345678/ \ -H "Authorization: Bearer pk_live_aBcDeFg..."

Raspuns exemplu

{ "cui": "12345678", "source": "ONRC (data.gov.ro)", "data": { "denumire": "EXEMPLU SRL", "cod_inmatriculare": "J40/1234/2015", "status": { "is_active": true, "is_insolventa": false, "labels": ["in functiune"] }, "administratori": [ { "nume": "POPESCU ION", "calitate": "ADMINISTRATOR" } ] }, "response_time_ms": 35 }
GET /api/v1/scoring/{cui}/ 1 credit

Scor de risc transparent (0-100) calculat pe baza datelor ANAF, MFP si ONRC. Include detalii pe categorii.

Parametri

Parametru Tip Obligatoriu Descriere
cui path Da Codul Unic de Inregistrare al firmei
# Scor risc pentru CUI 12345678 curl -X GET https://new.pepcheck.ro/api/v1/scoring/12345678/ \ -H "Authorization: Bearer pk_live_aBcDeFg..."

Raspuns exemplu

{ "cui": "12345678", "source": "PepCheck (ANAF + MFP + ONRC)", "score": 78, "level": "Risc moderat", "color": "#F59E0B", "categories": [ { "name": "Stare Juridica", "source": "ONRC", "max": 20, "score": 20 }, { "name": "Stare Fiscala", "source": "ANAF", "max": 20, "score": 18 } ], "response_time_ms": 350 }
GET /api/v1/dosare/{cui}/ 1 credit

Dosare instanta asociate firmei din portal.just.ro (ECRIS). Cautare automata pe numele firmei din ONRC/ANAF.

Parametri

Parametru Tip Obligatoriu Descriere
cui path Da Codul Unic de Inregistrare al firmei
# Dosare instanta pentru CUI 12345678 curl -X GET https://new.pepcheck.ro/api/v1/dosare/12345678/ \ -H "Authorization: Bearer pk_live_aBcDeFg..."

Raspuns exemplu

{ "cui": "12345678", "company_name": "EXEMPLU SRL", "source": "portal.just.ro (ECRIS)", "total_court_cases": 2, "court_cases": [ { "caseNumber": "1234/300/2024", "date": "2024-03-15", "institution": "Judecatoria Sectorul 3 BUCURESTI", "department": "Sectia Civila", "caseCategory": "Civil", "subject": "pretentii", "proceduralStage": "Fond", "partyStatus": "Parat", "lastUpdate": "2024-06-01", "hearingsCount": 5 } ], "response_time_ms": 2500 }
POST /api/v1/pep/ 3 credite

Verificare PEP (Persoane Expuse Politic) si sanctiuni internationale via OpenSanctions.

Parametri (JSON Body)

Parametru Tip Obligatoriu Descriere
name string Da Numele complet al persoanei/entitatii
type string Nu person sau entity
first_name string Nu Prenumele (imbunatateste acuratetea)
last_name string Nu Numele de familie
birth_date string Nu Data nasterii (YYYY-MM-DD)
nationality string Nu Nationalitate (cod ISO 2 litere, ex: RO)
# Verificare PEP curl -X POST https://new.pepcheck.ro/api/v1/pep/ \ -H "Authorization: Bearer pk_live_aBcDeFg..." \ -H "Content-Type: application/json" \ -d '{ "name": "Popescu Ion", "type": "person", "nationality": "RO" }'

Raspuns exemplu

{ "query": "Popescu Ion", "type": "person", "source": "OpenSanctions", "result_status": "negative", "risk_score": 0, "total_matches": 0, "matches": [], "response_time_ms": 890 }
GET /api/v1/company/{cui}/ 1 credit

Evaluare completa a unei firme: ANAF + MFP + ONRC + Scoring intr-un singur request.

Parametri

Parametru Tip Obligatoriu Descriere
cui path Da Codul Unic de Inregistrare al firmei
# Evaluare completa firma curl -X GET https://new.pepcheck.ro/api/v1/company/12345678/ \ -H "Authorization: Bearer pk_live_aBcDeFg..."

Raspuns exemplu

{ "cui": "12345678", "sources": ["ANAF", "MFP", "ONRC", "PepCheck Scoring"], "anaf": { "date_generale": { "denumire": "EXEMPLU SRL" } }, "mfp": { "available": true, "years": 3, "data": [...] }, "onrc": { "available": true, "data": { "denumire": "EXEMPLU SRL" } }, "scoring": { "score": 78, "level": "Risc moderat" }, "response_time_ms": 520 }

Coduri Eroare

API-ul returneaza coduri HTTP standard. In caz de eroare, raspunsul include campul error cu detalii.

Cod Status Descriere
200 OK Request procesat cu succes
400 Bad Request Parametri invalizi sau lipsa. Verificati body-ul request-ului.
401 Unauthorized Cheie API invalida, expirata sau lipsa din header.
404 Not Found Resursa nu a fost gasita (CUI inexistent sau endpoint invalid).
429 Too Many Requests Rate limit depasit sau credite insuficiente. Verificati header-ele X-RateLimit.
500 Internal Server Error Eroare interna server. Reincercati sau contactati suportul.
502 Bad Gateway Sursa externa indisponibila (ANAF, MFP, ONRC). Reincercati in cateva minute.

Exemplu raspuns eroare

{ "error": "Unauthorized", "message": "Invalid or expired API key", "status_code": 401 }

Rate Limiting

Limita de request-uri se aplica per cheie API si este configurabila la nivel de cont.

Limita implicita

10 req/min

Per cheie API. Limita poate fi crescuta la cerere pentru planurile Enterprise si Custom.

Header-e raspuns

Fiecare raspuns include header-e cu informatii despre rate limit:

X-RateLimit-Limit: 10 X-RateLimit-Remaining: 7

Sfat implementare

Cand primiti raspunsul 429 Too Many Requests, implementati un mecanism de retry cu backoff exponential. Verificati header-ul X-RateLimit-Remaining pentru a preveni depasirea limitei.

Sistem de Credite

Fiecare request consuma un numar de credite in functie de endpoint. Verificati creditul ramas oricand prin /api/v1/status/.

Endpoint Metoda Cost Descriere
/api/v1/status/ GET 0 credite Status cont
/api/v1/anaf/{cui}/ GET 1 credit Date fiscale ANAF
/api/v1/mfp/{cui}/ GET 1 credit Bilanturi MFP
/api/v1/onrc/{cui}/ GET 1 credit Registrul Comertului
/api/v1/scoring/{cui}/ GET 1 credit Scor risc
/api/v1/dosare/{cui}/ GET 1 credit Dosare instanta
/api/v1/pep/ POST 3 credite Verificare PEP & Sanctiuni
/api/v1/company/{cui}/ GET 1 credit Evaluare completa firma

Monitorizare credite

Folositi endpoint-ul GET /api/v1/status/ (0 credite) pentru a verifica oricand numarul de credite ramase. Creditele se reseteaza lunar la data facturarii.

Incepeti acum

Creati un cont Enterprise pentru a obtine cheia API sau contactati-ne pentru un plan personalizat.

Acceseaza Platforma Contacteaza-ne