Prospectare

Liste filtrate de firme (1 credit la 25 de firme)

Changed on

Prospectare pe CAEN / județ / localitate / formă juridică / stare / TVA / e-Factura / vechime / benzi de mărime. Obligatoriu cel puțin caen sau county. Rândurile conțin DOAR date de persoană juridică — fără reprezentanți sau contact. Revânzarea în bloc e interzisă (ToS).

get/api/v1/companies

Request

  • Base URL: https://firmoscop.ro
  • URL: https://firmoscop.ro/api/v1/companies
  • Auth: one of:
    • HTTP bearer
    • API key in cookie fs_session

Query parameters

caenstring

Cod CAEN sau prefix (ex. 41 = toată diviziunea construcții).

countystring

Județ (ex. Cluj) — diacriticele nu contează.

state'active' | 'insolvent'
vat'true' | 'false'

Plătitor de TVA.

minTurnoverinteger

Cifra de afaceri minimă (lei), din ultimul bilanț.

minEmployeesinteger

Numărul minim de angajați.

legalFormstring

Forma juridică, exact (SRL, SA, PFA, II, IF, AF, PF, SNC…).

localitystring

Localitatea (ex. Cluj-Napoca) — diacriticele nu contează.

addressstring

Text din adresa sediului (stradă / cod poștal). ONRC abreviază — caută partea distinctivă.

localityType'urban' | 'rural'

Mediul: urban (municipii, orașe, sectoare) sau rural (comune, sate). Localitățile fără prefix recunoscut nu intră în niciuna.

finYearinteger

Anul de bilanț pe care se aplică pragurile financiare (implicit: ultimul bilanț al fiecărei firme).

turnoverGrowthPctnumber

Evoluția cifrei de afaceri față de anul precedent, în %: pozitiv = creștere minimă, negativ = scădere minimă.

efactura'true' | 'false'

Înscrisă în RO e-Factura.

finantare'true' | 'false'

A încasat finanțare publică (PNRR). Filtru îngust: sub 3.000 de societăți din tot registrul.

inactive'true' | 'false'

Declarată inactivă fiscal de ANAF.

registeredAfterstring date

Înmatriculată la/după data asta (YYYY-MM-DD).

registeredBeforestring date

Înmatriculată până la data asta.

maxTurnoverinteger

Cifra de afaceri maximă (lei) — benzi de mărime.

maxEmployeesinteger

Numărul maxim de angajați.

sort'turnover'

sort=turnover → cele mai mari firme întâi (implicit: după CUI).

pageinteger
pageSizeinteger

Response

Pagină de firme + credite rămase.

filtersobject
pageinteger
pageSizeinteger
totalinteger
creditsChargedinteger

Creditele debitate pentru pagină: ceil(rânduri / 25), minimum 1.

creditsRemaininginteger

Changes