3 endpoint-uri complementare

API Administratori Firmă

Trei endpoint-uri complementare — găsește administratorii unei firme, extinde cu toate firmele lor, sau caută o persoană după nume și vezi firmele unde e admin.

Necesita abonament platit— creditele gratuite nu includ acest endpoint

2 endpoint-uri

3.5M+ firme ONRC

Actualizat zilnic

5 credite / interogare

Obține Cheie API Documentație

GET /api/v1/persoana/cauta?nume=Alex+Exemplu

EXEMPLU ALEX

București · 5 firme

3 active

EXEMPLU TECH SRL

CUI 12345678 · J40/1234/2020

Administrator

EXEMPLU BUILD SRL

CUI 87654321 · J40/9999/2018

Asociat

EXEMPLU EXPORT SRL

CUI 11223344 · J40/5555/2019

Încetat

3 persoane · 8 firme200 OK · 124ms

3 endpoint-uri

Trei perspective, aceleași date

De la firmă la administratori, de la administratori la toate firmele lor, sau de la nume la firme. Toate integrate într-un singur API.

Forward lookup

Administratori după CUI

Furnizezi CUI-ul unei firme, primești lista completă a administratorilor, asociaților și celorlalte funcții.

Nume, funcție, stare, dată
Istoric complet firmă
Date actualizate din ONRC

Vezi documentația

Cross-search

Administratori + alte firme

Combină primul endpoint cu reverse lookup — pentru fiecare admin al firmei, primești și celelalte firme unde apare.

Auto-identificare persoane
Grafic conexiuni complete
1 apel = firmă + toate legăturile

Vezi documentația

NOU

Reverse lookup

Persoană după nume

Cauți după numele persoanei și primești toate firmele la care e administrator, asociat sau altă funcție.

Match strict pe cuvinte + diacritice
Dezambiguare automată persoane
Filtre județ, tip funcție, activ

Vezi documentația

Documentație API

Trei endpoint-uri complementare · integrare simplă în orice limbaj

Endpoint 01·

Administratori după CUI

Furnizezi CUI-ul unei firme, primești lista completă a administratorilor, asociaților, cenzorilor și lichidatorilor cu funcțiile lor.

GEThttps://www.firmeapi.ro/api/v1/administratori/{cui}5 credite

Parametri

cui

Codul Unic de Identificare al firmei (obligatoriu)

Exemplu: 12345678

Exemplu Request

curl "https://www.firmeapi.ro/api/v1/administratori/12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemplu Response

200 OK

{
  "cui": "12345678",
  "denumire": "EXEMPLU TECH SRL",
  "nr_reg_com": "J40/1234/2020",
  "stare": "Funcțiune",
  "adresa": {
    "judet": "București",
    "localitate": "Sector 1"
  },
  "administratori": [
    {
      "nume": "EXEMPLU ALEX",
      "tip": "Administrator",
      "stare": "Activ",
      "data": "2020-05-15"
    }
  ]
}

Endpoint 02 · Cross-search·

Administratori + alte firme ale lor

Extinde endpoint-ul 01: pentru fiecare administrator persoană fizică, adaugă lista tuturor celorlalte firme unde persoana apare ca admin/asociat. Identificarea persoanei se face intern după numele complet + data nașterii.

GEThttps://www.firmeapi.ro/api/v1/administratori/{cui}/firme5 credite

Diferență față de Endpoint 01: /administratori/{cui} întoarce doar administratorii firmei. /administratori/{cui}/firme întoarce administratori + toate firmele lor într-un singur apel.

Parametri

cui

CUI-ul firmei pentru care extragi administratori + alte firme

Cost fix indiferent de numărul de admini · Rate limit 60/min

Exemplu Request

curl "https://www.firmeapi.ro/api/v1/administratori/12345678/firme" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemplu Response

200 OK

{
  "cui": "12345678",
  "denumire": "EXEMPLU TECH SRL",
  "administratori": [
    {
      "nume": "EXEMPLU ALEX",
      "tip": "Persoană Fizică",
      "calitate": "Administrator",
      "stare": "Activ",
      "alte_firme": {
        "disponibil": true,
        "total": 4,
        "items": [
          {
            "cui": "87654321",
            "denumire": "EXEMPLU BUILD SRL",
            "nr_reg_com": "J40/9999/2018",
            "stare": "Funcțiune",
            "calitate": "Asociat"
          },
          {
            "cui": "11223344",
            "denumire": "EXEMPLU EXPORT SRL",
            "nr_reg_com": "J40/5555/2019",
            "stare": "Radiată",
            "calitate": "Administrator"
          }
        ]
      }
    }
  ]
}

Endpoint 03 · Reverse lookupNOU·

Persoană după nume

Cauți după nume și primești toate firmele unde persoana e admin/asociat. Dezambiguare automată după data nașterii (privată, nu se returnează).

GEThttps://www.firmeapi.ro/api/v1/persoana/cauta?nume={nume}5 credite

Parametri query

Param	Tip	Default	Descriere
`nume`req	string	—	Nume complet, min 3 caractere. Ex: „Alex Exemplu"
`strict`	boolean	true	Match exact pe set de cuvinte. False = admin poate avea cuvinte extra.
`doar_activ`	boolean	true	Doar funcții curente. False = tot istoricul.
`judet`	string	—	Filtru județ. Ex: „B" (București), „Cluj"
`tip`	enum	—	administrator · asociat · cenzor · lichidator · pf · pj
`pagina`	integer	1	Max 50
`limit`	integer	20	Max 100 rezultate/pagină

Match strict (default)

Tolerant diacritice, case, cratime, ordine

EXEMPLU ALEXdiacritice + ordine

alex-exemplucase + cratimă

ALEX EXEMPLU-TESTtoken extra

EXEMPLU B. ALEXinițial extra

Exemplu Request

curl "https://www.firmeapi.ro/api/v1/persoana/cauta?nume=Alex+Exemplu" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemplu Response

200 OK

{
  "cautare": "Alex Exemplu",
  "mod_cautare": "strict",
  "total_persoane": 3,
  "total_firme": 8,
  "persoane": [
    {
      "nume": "EXEMPLU ALEX",
      "judete": ["București"],
      "total_firme": 5,
      "firme_active": 3,
      "firme": [
        {
          "cui": "12345678",
          "denumire": "EXEMPLU TECH SRL",
          "nr_reg_com": "J40/1234/2020",
          "tip_functie": "Administrator",
          "calitate": "Administrator",
          "stare_functie": "Activ",
          "data_numire": "2020-05-15"
        }
      ]
    }
  ]
}

Privacy: Data nașterii se folosește DOAR intern pentru dezambiguarea persoanelor cu nume identic. NU se returnează în răspuns. Nu returnăm CNP, adrese personale sau alte date sensibile.

Autentificare

Toate requesturile necesită API key în header:

Authorization: Bearer YOUR_API_KEY

Generează cheia din Dashboard → Chei API.

Expuse ca MCP tools:

administratoricauta_persoana

Coduri de Răspuns

200Răspuns valid, JSON returnat

400Parametru invalid (ex: nume < 3 caractere)

401Cheie API invalidă sau lipsă

402Credit insuficient

404CUI-ul nu există în bază

429Rate limit depășit (60/min)

Începe în mai puțin de 2 minute

1000 credite gratuite/lună la înregistrare. Fără card, fără abonament. Aprobare admin în < 2h.

Creează cont gratuit Vezi abonamentele