Firmeo pune la dispoziție un API REST prin care aduci datele firmelor din România direct în CRM-ul, aplicația sau fluxurile tale de lucru. Trimiți codul fiscal (CUI) al unei firme și primești instantaneu un răspuns structurat în format JSON, gata de integrat. Interogarea se poate face din orice limbaj de programare — găsești mai jos exemple complete în PHP, Python, Node.js și cURL.
Denumire, CUI, număr de înregistrare la Registrul Comerțului, adresă, județ, localitate, cod CAEN, stare ANAF și statut TVA.
Persoana de conducere, telefon, adresă de email și website — acolo unde sunt disponibile.
Cifră de afaceri, profit net, număr de salariați, active imobilizate, active circulante, capitaluri, datorii, venituri, cheltuieli și stocuri, pe anul solicitat.
Pentru bilanțul unui anumit an, adaugă parametrul an_bilant (de exemplu an_bilant=2025) în interogare. Fără el, răspunsul conține datele de identificare, contactele și lista anilor pentru care există bilanț.
/* ****************************** */
/* Sistemul API poate fi utilizat */
/* doar cu pachetele Economic, */
/* Standard sau Superior!!! */
/* Suport: [email protected] */
/* ****************************** */
$url = "https://firmeo.ro/api.php";
$data['user'] = "[email protected]"; //adresa de email cu care se face autentificarea in cont$data['api_key'] = "SDKDGKSKGSDKGS"; //codul care se generează din contul meu dupa autentificare: https://firmeo.ro/setari.php
$data['cif'] = "41292670"; //cif firma interogată$data['an_bilant'] = "2025"; //optional: bilantul pe un anumit an
$options = array(
'http' => array(
'header' => "Content-type: application/x-www-form-urlencoded\r\n",
'method' => 'POST',
'content' => http_build_query($data),
),
);
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
if ($result === FALSE)
{
echo "API error";
}
print_r (json_decode($result,true));
Acesta este un exemplu de răspuns în JSON primit de la API:
// Exemplu ilustrativ (date fictive), cu structura reală a răspunsului
// 1) Cerere cu user, api_key și cif: datele firmei, anii cu bilanț și contactele
{
"firma":{
"cif":"12345678",
"an_infiintare":"2015",
"caen":"4690",
"reg_com":"J2015000123456",
"denumire":"EXEMPLU DISTRIBUTIE SRL",
"judetul":"CLUJ",
"localitate":"Cluj-Napoca",
"adresa":"Str. Exemplului nr. 1",
"cod_postal":"400001",
"tva":"2016-03-01",
"tva_la_incasare":"0",
"stare_anaf":"1",
"actualizare":"2026-10-02 04:03:46"
},
"ani_bilant":"2015,2016,2017,2018,2019,2020,2021,2022,2023,2024,2025",
"extra":[
{"tip":"conducere","valoare":"Nume Prenume","observatii":""},
{"tip":"mobil","valoare":"07xx xxx xxx","observatii":""},
{"tip":"email","valoare":"[email protected]","observatii":""},
{"tip":"website","valoare":"www.exemplu.ro","observatii":""}
],
"user":{
"utilizator":"[email protected]",
"credit_initial":"500",
"credit_ramas":"499"
}
}
// 2) Aceeași cerere + an_bilant=2025: bilanțul pe anul ales
{
"firma":{
"cif":"12345678"
},
"bilant":{
"an":"2025",
"cifra_de_afaceri_neta":"2952255",
"profit_net":"625486",
"salariati":"17",
"active_imobilizate":"1204330",
"active_circulante":"1183200",
"capitaluri_total":"1683182",
"datorii":"471317",
"venituri":"2960110",
"cheltuieli":"2210450",
"stocuri":"184200"
},
"user":{
"utilizator":"[email protected]",
"credit_initial":"499",
"credit_ramas":"499"
}
}
Răspunsuri scurte despre API-ul Firmeo.