---
title: "Liste filtrate de firme (1 credit la 25 de firme)"
method: GET
path: "/api/v1/companies"
tags: ["Prospectare"]
---

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

`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`

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).

## Query parameters

- `caen` string
- `county` string
- `state` 'active' | 'insolvent'
- `vat` 'true' | 'false'
- `minTurnover` integer
- `minEmployees` integer
- `legalForm` string
- `locality` string
- `address` string
- `localityType` 'urban' | 'rural'
- `finYear` integer
- `turnoverGrowthPct` number
- `efactura` 'true' | 'false'
- `finantare` 'true' | 'false'
- `inactive` 'true' | 'false'
- `registeredAfter` string, date
- `registeredBefore` string, date
- `maxTurnover` integer
- `maxEmployees` integer
- `sort` 'turnover'
- `page` integer
- `pageSize` integer

## Response `200`

Pagină de firme + credite rămase.

- object
  - `filters` object
  - `page` integer
  - `pageSize` integer
  - `total` integer
  - `creditsCharged` integer: Creditele debitate pentru pagină: ceil(rânduri / 25), minimum 1.
  - `creditsRemaining` integer
  - `data` CompanyListRow[]
    - `cui` string
    - `name` string
    - `county` string, nullable
    - `locality` string, nullable
    - `caenCode` string, nullable
    - `caenLabel` string, nullable
    - `registrationState` string, nullable
    - `vatRegistered` boolean, nullable
    - `registeredAt` string, date, nullable

## Other responses

- `400`: Eroare — corp JSON { error, message } în limbaj natural.
- `401`: Eroare — corp JSON { error, message } în limbaj natural.
- `402`: Plafonul lunar rămas și soldul, adunate, nu acoperă pagina. Corpul are `cost`, `remaining` (plafon + sold) și `rows`; nu se debitează nimic.
- `429`: Eroare — corp JSON { error, message } în limbaj natural.

## Changes

- **2026-10-19** `c80445538255`: 1 info
  - added the optional property `creditsCharged` to the response with the `200` status

[Operation history](https://skmtc.dev/firmoscop/apis/firmoscop-api/changes/api/v1/companies/get.md)

---

[API](https://skmtc.dev/firmoscop/apis/firmoscop-api.md) · [All operations](https://skmtc.dev/firmoscop/apis/firmoscop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firmoscop/apis/firmoscop-api/revisions/58c82b29bbfc?raw)