FirmaCheck.ro
API FirmaCheck

Verificare firme prin API pentru aplicații B2B

Integrează date fiscale, scor de risc, insolvență, dosare, bilanțuri și limită credit direct în CRM, ERP, marketplace sau aplicația ta.

Autentificarea se face exclusiv prin header-ul X-API-Key. Nu transmite cheia API în URL sau query string.
Vezi plan Business Cere acces API 
curl -H "X-API-Key: fc_live_xxxxxxxxxxxxxxxx" \
https://firmacheck.ro/api/v1/company/4611791

Endpoint verificare firmă

Returnează date despre firmă, scor FirmaCheck, semnale de risc, insolvență, dosare și sumar financiar. 

GET https://firmacheck.ro/api/v1/company/{cui}
Metodă
GET
Parametru
cui
Header obligatoriu
X-API-Key
Format răspuns
JSON

Exemplu request 

curl -H "X-API-Key: fc_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
https://firmacheck.ro/api/v1/company/4611791

Cheia completă este afișată o singură dată, în momentul generării sau regenerării. În dashboard vezi doar prefixul, data regenerării și ultima utilizare.

Exemplu răspuns 

{
  "ok": true,
  "data": {
    "cui": "4705349",
    "name": "CARNIPROD SRL",
    "registration_number": "J36/813/1993",
    "address": "JUD. TULCEA, MUN. TULCEA, ȘOS. TULCEA-MURIGHIOL, NR.KM.4-5",
    "phone": "0240505100",
    "postal_code": "820250",
    "legal_form": "SOCIETATE COMERCIALĂ CU RĂSPUNDERE LIMITATĂ",
    "fiscal_body": "Administraţia Fiscală pentru Contribuabili Mijlocii - Tulcea",
    "active": true,
    "inactive_since": null,
    "vat_payer": true,
    "e_invoice": true,
    "caen": "1013",
    "main_activity": "Fabricarea produselor din carne (inclusiv din carne de pasăre)",
    "euid": "ROONRC.J1993000813367",
    "onrc_registration_code": "J1993000813367",
    "onrc_status": "funcțiune",
    "onrc_active": true,

    "onrc": {
      "source": "onrc_data_gov",
      "found": true,
      "euid": "ROONRC.J1993000813367",
      "registration_code": "J1993000813367",
      "status": "funcțiune",
      "status_code": 1048,
      "active": true,
      "legal_form": "SRL",
      "address": "Tulcea, Municipiul Tulcea, Str. TULCEA-MURIGHIOL, nr. KM.4-5, CP 8800",
      "representatives": [
        {
          "name": "DUBOU PETRU",
          "role": "administrator",
          "source": "onrc_data_gov"
        }
      ],
      "authorized_caen": [
        {
          "code": "1013",
          "name": "Fabricarea produselor din carne (inclusiv din carne de pasăre)",
          "version": 3,
          "source": "onrc_data_gov"
        }
      ]
    },

    "risk": {
      "score": 80,
      "level": "low",
      "verdict": "OK pentru colaborare",
      "credit_limit": 255400,
      "signals": []
    },

    "insolvency": {
      "detected": false,
      "bankruptcy": false,
      "case_number": null,
      "object": null
    },

    "cases": {
      "count": 41,
      "negative_count": 41,
      "positive_count": 0,
      "neutral_count": 0,
      "items": []
    },

    "financial_summary": {
      "year": 2024,
      "revenue": 99851272,
      "profit": 638017,
      "debt": 9045252,
      "equity": 110679183,
      "employees": 261
    },

    "meta": {
      "source": "FirmaCheck.ro",
      "primary_company_source": "anaf_tva",
      "company_sources": ["anaf_tva", "onrc_data_gov"],
      "financial_source": "anaf_bilant",
      "onrc_source": "onrc_data_gov",
      "generated_at": "2026-05-15T12:00:00+03:00",
      "request_id": "00000000-0000-0000-0000-000000000000"
    }
  }
}
Datele ONRC sunt furnizate din seturile publice data.gov.ro și includ EUID, cod ONRC data.gov, stare ONRC, reprezentanți și CAEN autorizate. Datele fiscale, TVA, telefonul și codul poștal sunt prioritizate din ANAF când sunt disponibile.

Coduri de eroare

Erorile sunt returnate într-un format JSON standardizat, cu ok: false și un cod intern stabil.

Status Cod Cauză Mesaj
401 missing_api_key Lipsește header-ul API Missing API key. Send it using the X-API-Key header.
401 invalid_api_key Cheie API invalidă sau regenerată Invalid API key.
403 api_not_enabled Plan fără API activ API access is available only for active Business users with API enabled.
422 invalid_cui CUI invalid Invalid CUI. Use 2 to 10 digits, without RO prefix.
429 monthly_limit_exceeded Limită lunară atinsă Monthly API request limit exceeded.
500 internal_error Eroare internă temporară Internal API error.

Exemple răspunsuri de eroare

401 — missing_api_key
{
  "ok": false,
  "error": {
    "code": "missing_api_key",
    "message": "Missing API key. Send it using the X-API-Key header."
  }
}
429 — monthly_limit_exceeded
{
  "ok": false,
  "error": {
    "code": "monthly_limit_exceeded",
    "message": "Monthly API request limit exceeded."
  },
  "limit": 5000,
  "used": 5000
}

Vrei acces API?

API-ul este inclus în planul Business cu aprobare. După aprobare primești cheia API fc_live_... și poți începe integrarea.

Vezi plan Business