---
title: "Descarcă lista de prospectare ca CSV (primele 50 de rânduri gratuite, apoi 1 credit la 25)"
method: GET
path: "/api/v1/companies/export.csv"
tags: ["Prospectare"]
---

# Descarcă lista de prospectare ca CSV (primele 50 de rânduri gratuite, apoi 1 credit la 25)

`GET /api/v1/companies/export.csv`

## Request

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

Aceleași filtre ca `/companies`, dar întoarce un CSV descărcabil (max 500 firme, cele mai mari după cifra de afaceri) — lista de lead-uri pentru o echipă de vânzări. Costul se calculează pe rândurile livrate: ceil(max(0, rânduri − 50) / 25) credite, deci 500 de rânduri = 18 credite, la fel pe sesiune și pe cheie. Același export (aceleași filtre și același `limit`) repetat în 24 de ore nu se taxează a doua oară. Fără date de contact/reprezentanți. 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'
- `inactive` 'true' | 'false'
- `registeredAfter` string, date
- `registeredBefore` string, date
- `maxTurnover` integer
- `maxEmployees` integer
- `limit` integer

## Response `200`

Fișier CSV (text/csv), max 500 firme.

## 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ă fișierul. Corpul are `cost`, `remaining` (plafon + sold), `rows` și `freeRows` (50); nu se debitează nimic. O navigare de browser primește o pagină cu varianta gratuită.
- `429`: Eroare — corp JSON { error, message } în limbaj natural.

## Changes

- **2026-10-19** `c80445538255`: 1 info
  - added the new optional `query` request parameter `limit`

[Operation history](https://skmtc.dev/firmoscop/apis/firmoscop-api/changes/api/v1/companies/export.csv/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)