API

Documentație API SRLuri.ro

Endpointurile de mai jos sunt folosite de aplicație și pot fi integrate controlat. Pentru endpointurile premium este necesar token de autentificare Supabase și abonament activ.

Autentificare și limite

Autentificare

Trimite headerul Authorization: Bearer TOKEN pentru endpointurile care cer cont sau abonament.

Rate limits

Endpointurile pot fi limitate pentru protecția serviciului. Pentru volume mari, folosește caching și paginare.

Format

Răspunsurile sunt JSON. Erorile includ câmpul error și status HTTP potrivit.

GET

Căutare firme după denumire

Caută firme după denumire. Folosit de căutarea principală din site.

Auth: Nu

Request

/api/companies?name=transport&limit=10&offset=0

Response

{
  "ok": true,
  "companies": [
    {
      "cui": "12345678",
      "denumire": "EXEMPLU TRANSPORT S.R.L.",
      "cod_inmatriculare": "J00/000/2020",
      "adr_judet": "Bucureşti",
      "adr_localitate": "Bucureşti Sectorul 1"
    }
  ],
  "total": 120
}

GET

Căutare firme după CAEN

Caută firme după unul sau mai multe coduri CAEN autorizate, cu filtre de județ, localitate și stare.

Auth: Abonament activ

Request

/api/companies/caen?caen=5610&judet=Argeş&limit=10&offset=0

Response

{
  "ok": true,
  "companies": [
    {
      "cui": "12345678",
      "denumire": "EXEMPLU RESTAURANT S.R.L.",
      "cod_caen_autorizat": "5610"
    }
  ],
  "total": 42
}

GET

Locații firme

Returnează județele și localitățile disponibile în platformă.

Auth: Nu

Request

/api/companies/locations

Response

{
  "locations": [
    {
      "adr_judet": "Cluj",
      "adr_localitate": "Cluj-Napoca"
    }
  ]
}

POST

Verificare CUI

Verifică un CUI și returnează date ANAF, TVA și bilanțuri disponibile.

Auth: Nu

Request

/api/search

Response

{
  "ok": true,
  "company": {
    "date_generale": {
      "cui": 47430489,
      "denumire": "BOFU S.R.L."
    }
  },
  "bilantYears": []
}