API REST · v1 · 33 endpoint-uri · live

API-ul NEXUS.
Firmele României, prin cod.

Validează parteneri, caută după orice câmp, ia bilanțuri și primește webhooks la modificări — peste 3.97M entități, sub o secundă. REST + JSON, autentificare cu cheie API.

https://api.arcadi.nexus Swagger interactiv Claude Skill MD

Începe în 30 de secunde

Toate cererile pleacă de la https://api.arcadi.nexus, peste HTTPS, cu răspuns JSON. Ai nevoie de o cheie API (vezi tab-ul ) pe care o trimiți în header-ul X-API-Key.

primul call

curl "https://api.arcadi.nexus/v1/firme/12345678/validate" \
  -H "X-API-Key: $NEXUS_KEY"

Autentificare

Chei API

Fiecare cerere trebuie să includă header-ul X-API-Key: nxs_live_.... Cheile sunt secrete — păstrează-le pe server, niciodată în cod client/public. Generează-le din tab-ul Chei API (protejat cu autentificare ARKNET).

Acces read-only — API-ul nu modifică niciodată datele firmelor.
O cheie lipsă/invalidă → 401; o cheie revocată → 403.

Rate limits

Limite per cheie

Fiecare răspuns include header-ele X-RateLimit-Limit, X-RateLimit-Remaining și X-RateLimit-Reset. La depășire primești 429 cu Retry-After (secunde). Limita implicită e per minut, configurabilă per cheie.

Erori

Format uniform

Erorile au mereu aceeași formă, cu un cod stabil și un request_id pentru debugging.

răspuns eroare

{
  "eroare": {
    "cod": "PARAMETRU_INVALID",
    "mesaj": "an_financiar este obligatoriu...",
    "detalii": [{ "camp": "an_financiar" }],
    "status": 422,
    "request_id": "01J..."
  }
}

200 ok

400 cerere malformată

401 cheie lipsă/invalidă

403 cheie revocată

404 negăsit

422 validare

429 rate limit

500 eroare internă

Paginare

limit & offset

Endpoint-urile de listă acceptă limit (1-100) și offset (max 10000). Răspunsul conține un obiect paginare cu are_pagina_urmatoare. Pentru rezultate foarte adânci, îngustează filtrele.

Securitate webhooks

Verifică semnătura HMAC

Fiecare livrare e semnată cu HMAC-SHA256 peste {timestamp}.{body}, în header-ul X-Nexus-Signature. Verifică-o constant-time și respinge timestamp-uri mai vechi de 5 minute.

verificare (Python)

import hmac, hashlib

def verify(secret: str, timestamp: str, raw_body: bytes, signature: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        f"{timestamp}.".encode() + raw_body,
        hashlib.sha256,
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

# headers: X-Nexus-Timestamp, X-Nexus-Signature, X-Nexus-Delivery (idempotency)

Firme

Profil complet, validare rapidă, batch și sub-resurse pentru orice entitate juridică.

GET /v1/firme/{cui} cheie

Profil complet al unei firme

Returnează profilul complet: identificare, adresă, contact, status fiscal, CAEN, administratori, și financiar_highlight (cifră/profit/salariați ultim an). Controlează secțiunile cu include și câmpurile cu fields.

Parametri

cui obligatoriu path

integer — Codul fiscal (CUI/CIF)

include query

string — Secțiuni opționale, separate prin virgulă: financiar_highlight, administratori, caen, bilanturi, tva, sucursale, modificari, all. Implicit: financiar_highlight,administratori,caen

an_bilant query

integer — Fixează anul pentru financiar_highlight

cerere · curl

curl "https://api.arcadi.nexus/v1/firme/12345678?include=financiar_highlight%2Cadministratori%2Ccaen" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "cui": 12345678,
    "denumire": "ACME PROD S.R.L.",
    "cod_inmatriculare": "J40/1234/2015",
    "euid": "ROONRC.J40/1234/2015",
    "data_inmatriculare": "2015-03-12",
    "is_radiata": false,
    "forma_juridica": {
      "cod": "SRL",
      "denumire": "Societate cu răspundere limitată"
    },
    "stare_curenta": {
      "cod": 8,
      "denumire": "FUNCTIONARE",
      "data": "2015-03-12"
    },
    "caen_principal": {
      "cod": "6201",
      "versiune": 2,
      "denumire": "Activități de realizare a soft-ului la comandă"
    },
    "adresa": {
      "judet": "București",
      "localitate": "Sector 1",
      "strada": "Bd. Exemplu",
      "numar": "10",
      "cod_postal": "010101",
      "adresa_text": "București, Sector 1, Bd. Exemplu nr. 10",
      "lat": 44.4631,
      "lng": 26.0954,
      "geo_precision": "street"
    },
    "contact": {
      "telefon": "+40 21 000 0000",
      "email": "contact@exemplu.ro",
      "website": "www.exemplu.ro",
      "iban": null
    },
    "fiscal": {
      "status_tva": true,
      "status_tva_incasare": false,
      "status_split_tva": false,
      "status_inactiv": false,
      "status_e_factura": true,
      "data_inreg_e_factura": "2022-07-01",
      "organ_fiscal_competent": "Administrația ... Sector 1"
    },
    "capital_social": 200000,
    "categorie_marime": "mica",
    "administrator": "Ion Exemplu",
    "financiar_highlight": {
      "an": 2024,
      "cifra_afaceri_neta": 4250000,
      "profit_net": 510000,
      "pierdere_neta": null,
      "numar_mediu_salariati": 18,
      "sursa": "bilanturi"
    },
    "administratori": [
      {
        "persoana_id": "00000000-0000-0000-0000-000000000001",
        "nume": "Ion Exemplu",
        "tip": "PF",
        "calitate": "administrator",
        "cota_procent": null,
        "aport": null,
        "data_inceput": "2015-03-12",
        "data_sfarsit": null,
        "is_curent": true
      }
    ],
    "caen_secundare": [
      {
        "cod": "6202",
        "versiune": 2,
        "denumire": "Activități de consultanță în tehnologia informației"
      }
    ]
  },
  "meta": {
    "versiune_api": "v1",
    "generat_la": "2026-05-26T10:00:00Z"
  }
}

GET /v1/firme/{cui}/validate cheie

Validare rapidă CUI (pentru facturare)

Verifică instant dacă un CUI e valid (checksum), dacă firma există și statusul fiscal — ideal pentru a valida un partener înainte de facturare. Întoarce 200 chiar dacă firma nu există (exista:false).

Parametri

cui obligatoriu path

integer — CUI de validat

cerere · curl

curl "https://api.arcadi.nexus/v1/firme/12345678/validate" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "cui": 12345678,
    "format_valid": true,
    "exista": true,
    "denumire": "ACME PROD S.R.L.",
    "is_radiata": false,
    "status_inactiv": false,
    "status_tva": true,
    "status_e_factura": true,
    "apta_facturare": true
  },
  "meta": {
    "versiune_api": "v1"
  }
}

POST /v1/firme/batch cheie

Rezolvă o listă de CUI-uri într-un singur call

Validează/rezolvă până la 100 de CUI-uri simultan. Fiecare intrare are un status (gasit/negasit/format_invalid). Ideal pentru a verifica mulți parteneri deodată.

cerere · curl

curl -X POST "https://api.arcadi.nexus/v1/firme/batch" \
  -H "X-API-Key: $NEXUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cui":[12345678,87654321,1],"include":["financiar_highlight"]}'

răspuns · 200

{
  "data": [
    {
      "cui": 12345678,
      "status": "gasit",
      "firma": {
        "cui": 12345678,
        "denumire": "ACME PROD S.R.L.",
        "forma_juridica": "SRL",
        "judet": "București",
        "is_radiata": false,
        "status_tva": true,
        "financiar_highlight": {
          "an": 2024,
          "cifra_afaceri_neta": 4250000,
          "profit_net": 510000,
          "numar_mediu_salariati": 18
        }
      }
    },
    {
      "cui": 87654321,
      "status": "negasit",
      "firma": null
    },
    {
      "cui": 1,
      "status": "format_invalid",
      "firma": null
    }
  ],
  "meta": {
    "solicitate": 3,
    "gasite": 1,
    "versiune_api": "v1"
  }
}

GET /v1/firme cheie

Căutare avansată după orice câmp principal

Filtrează după denumire (FTS română + fuzzy), administrator, județ, localitate, CAEN, formă juridică, status-uri, dată înmatriculare și indicatori financiari. Filtrele financiare (cifra_*, profit_*, salariati_*) cer an_financiar. Paginare cu limit/offset.

Parametri

q query

string — Căutare denumire (FTS + fuzzy, min 2 caractere)

administrator query

string — Nume administrator (fuzzy, min 3)

judet query

string — Județ

localitate query

string — Localitate (necesită și judet)

cod_caen query

string — Cod CAEN

caen_mod query

enum(principal|orice) — Caută în CAEN principal sau și în secundare. Implicit principal

forma_juridica query

string — Cod formă juridică (SRL, SA, PFA...)

status_tva query

boolean — Plătitor TVA

status_inactiv query

boolean — Inactiv fiscal

status_e_factura query

boolean — Înregistrat e-Factura

is_radiata query

boolean — Radiată

inmatriculare_de_la query

date — Înmatriculate de la (YYYY-MM-DD)

inmatriculare_pana_la query

date — Înmatriculate până la

cifra_min query

number — Cifră de afaceri minimă (cere an_financiar)

cifra_max query

number — Cifră de afaceri maximă

profit_min query

number — Profit net minim

salariati_min query

integer — Număr salariați minim

an_financiar query

integer — Anul pentru filtrele financiare (2009-2024). OBLIGATORIU dacă filtrezi/sortezi financiar

sort query

order query

enum(asc|desc) — Direcție sortare

limit query

integer — Rezultate per pagină (1-100, implicit 20)

offset query

integer — Decalaj (max 10000)

cerere · curl

curl "https://api.arcadi.nexus/v1/firme?judet=Cluj&cod_caen=6201&an_financiar=2024&sort=cifra&order=desc&limit=20" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cui": 12345678,
      "denumire": "ACME PROD S.R.L.",
      "cod_inmatriculare": "J12/100/2015",
      "forma_juridica": "SRL",
      "judet": "Cluj",
      "localitate": "Cluj-Napoca",
      "cod_caen_principal": "6201",
      "is_radiata": false,
      "status_tva": true
    }
  ],
  "paginare": {
    "limit": 20,
    "offset": 0,
    "are_pagina_urmatoare": true,
    "cursor_urmator": null,
    "total": null
  },
  "meta": {
    "sort": "cifra",
    "order": "desc",
    "versiune_api": "v1"
  }
}

GET /v1/firme/{cui}/administratori cheie

Administratori (curenți + istoric)

Parametri

cui obligatoriu path

integer — CUI

doar_curenti query

boolean — Doar administratorii curenți

cerere · curl

curl "https://api.arcadi.nexus/v1/firme/12345678/administratori" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "persoana_id": "00000000-0000-0000-0000-000000000001",
      "nume": "Ion Exemplu",
      "tip": "PF",
      "calitate": "administrator",
      "is_curent": true,
      "data_inceput": "2015-03-12",
      "data_sfarsit": null
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/firme/{cui}/bilanturi cheie

Bilanțuri (istoric multi-anual 2009-2024)

Parametri

cui obligatoriu path

integer — CUI

de_la query

integer — An minim

pana_la query

integer — An maxim

cerere · curl

curl "https://api.arcadi.nexus/v1/firme/12345678/bilanturi" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "an": 2024,
      "cifra_afaceri_neta": 4250000,
      "venituri_totale": 4300000,
      "cheltuieli_totale": 3700000,
      "profit_brut": 600000,
      "profit_net": 510000,
      "pierdere_neta": null,
      "numar_mediu_salariati": 18,
      "datorii_totale": 900000,
      "capitaluri_total": 1500000
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/firme/{cui}/caen cheie

CAEN principal + secundare

Parametri

cui obligatoriu path

integer — CUI

cerere · curl

curl "https://api.arcadi.nexus/v1/firme/12345678/caen" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "principal": {
      "cod": "6201",
      "versiune": 2,
      "denumire": "Activități de realizare a soft-ului la comandă"
    },
    "secundare": [
      {
        "cod_caen": "6202",
        "versiune_caen": 2,
        "denumire": "Consultanță IT"
      }
    ]
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/firme/{cui}/tva cheie

Istoric perioade TVA

Parametri

cui obligatoriu path

integer — CUI

cerere · curl

curl "https://api.arcadi.nexus/v1/firme/12345678/tva" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "data_inceput": "2016-01-01",
      "data_sfarsit": null,
      "data_anulare": null,
      "motiv_anulare": null,
      "is_curent": true
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/firme/{cui}/sucursale cheie

Sucursale în alte state membre UE

Parametri

cui obligatoriu path

integer — CUI

cerere · curl

curl "https://api.arcadi.nexus/v1/firme/12345678/sucursale" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "tara_membra": "Germania",
      "denumire_locala": "ACME GmbH",
      "identificator": "DE123456789"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/firme/{cui}/modificari cheie

Istoric modificări (audit)

Schimbări detectate în timp (denumire, sediu, status fiscal, administratori) prin diff între versiuni succesive ONRC/ANAF.

Parametri

cui obligatoriu path

integer — CUI

limit query

integer — Max înregistrări (1-200, implicit 50)

cerere · curl

curl "https://api.arcadi.nexus/v1/firme/12345678/modificari" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "field_name": "telefon",
      "old_value": "+40 21 000 0000",
      "new_value": "+40 21 111 1111",
      "changed_at": "2026-04-10T08:00:00Z",
      "data_source": "anaf/v9"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

Persoane

Administratori și reprezentanți — caută o persoană și vezi toate firmele administrate.

GET /v1/persoane/{id} cheie

Detaliu persoană + firmele administrate

Parametri

id obligatoriu path

uuid — ID-ul persoanei (UUID)

limit_firme query

integer — Câte firme să includă (1-200)

cerere · curl

curl "https://api.arcadi.nexus/v1/persoane/00000000-0000-0000-0000-000000000001" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000001",
    "nume": "Ion Exemplu",
    "tip": "PF",
    "judet_curent": "Cluj",
    "rezumat": {
      "firme_total": 3,
      "firme_curente": 2
    },
    "firme": [
      {
        "cui": 12345678,
        "denumire": "ACME PROD S.R.L.",
        "calitate": "administrator",
        "is_curent": true
      }
    ]
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/persoane cheie

Caută persoane după nume (fuzzy)

Parametri

nume obligatoriu query

string — Nume (fuzzy trigram, min 3 caractere)

tip query

enum(PF|PJ) — Persoană fizică sau juridică

judet_curent query

string — Județ reședință

limit query

integer — 1-100

offset query

integer — max 10000

cerere · curl

curl "https://api.arcadi.nexus/v1/persoane?nume=exemplu&tip=PF&limit=20" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000001",
      "nume": "Ion Exemplu",
      "tip": "PF",
      "judet_curent": "Cluj"
    }
  ],
  "paginare": {
    "limit": 20,
    "offset": 0,
    "are_pagina_urmatoare": false,
    "total": null
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/persoane/{id}/firme cheie

Firmele unei persoane (paginat)

Parametri

id obligatoriu path

uuid — ID persoană

limit query

integer — 1-200

offset query

integer — max 10000

cerere · curl

curl "https://api.arcadi.nexus/v1/persoane/00000000-0000-0000-0000-000000000001/firme" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cui": 12345678,
      "denumire": "ACME PROD S.R.L.",
      "calitate": "administrator",
      "is_curent": true,
      "judet": "Cluj"
    }
  ],
  "paginare": {
    "limit": 50,
    "offset": 0,
    "are_pagina_urmatoare": false,
    "total": null
  },
  "meta": {
    "versiune_api": "v1"
  }
}

ONG-uri

Organizații neguvernamentale — profil, căutare și bilanțuri specifice ONG.

GET /v1/ong/{cui} cheie

Detaliu ONG

Parametri

cui obligatoriu path

integer — CUI

cerere · curl

curl "https://api.arcadi.nexus/v1/ong/12345678" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "cui": 12345678,
    "denumire": "ASOCIAȚIA EXEMPLU",
    "forma_juridica": "AS",
    "data_inmatriculare": "2018-05-01",
    "judet": "Iași",
    "localitate": "Iași",
    "cod_caen_economic": "9499",
    "caen_economic_den": "Alte activități asociative n.c.a.",
    "status_tva": false,
    "is_radiata": false
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/ong cheie

Caută ONG-uri

Parametri

q query

string — Denumire (FTS + fuzzy)

judet query

string — Județ

localitate query

string — Localitate (necesită judet)

status_tva query

boolean — Plătitor TVA

is_radiata query

boolean — Radiată

limit query

integer — 1-100

cerere · curl

curl "https://api.arcadi.nexus/v1/ong?q=exemplu&judet=Ia%C8%99i" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cui": 12345678,
      "denumire": "ASOCIAȚIA EXEMPLU",
      "judet": "Iași",
      "localitate": "Iași",
      "cod_caen_economic": "9499",
      "is_radiata": false
    }
  ],
  "paginare": {
    "limit": 20,
    "offset": 0,
    "are_pagina_urmatoare": false,
    "total": null
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/ong/{cui}/bilanturi cheie

Bilanțuri ONG (istoric)

Parametri

cui obligatoriu path

integer — CUI

cerere · curl

curl "https://api.arcadi.nexus/v1/ong/12345678/bilanturi" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "an": 2024,
      "cifra_afaceri_neta": 350000,
      "profit_net": 12000,
      "numar_mediu_salariati": 4
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

Unități de învățământ

Școli, licee și universități din rețeaua MEN, cu legătură la firma/PJ asociată.

GET /v1/unitati-invatamant/{cod_siiir} cheie

Detaliu unitate de învățământ

Parametri

cod_siiir obligatoriu path

string — Cod SIIIR

cerere · curl

curl "https://api.arcadi.nexus/v1/unitati-invatamant/0000000001" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "cod_siiir": "0000000001",
    "denumire_lunga": "LICEUL TEORETIC EXEMPLU",
    "tip": "Liceu",
    "judet": "Brașov",
    "localitate": "Brașov",
    "is_publica": true,
    "cod_fiscal_pj": 12345678,
    "firma_asociata": {
      "cui": 12345678,
      "link": "/v1/firme/12345678"
    }
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/unitati-invatamant cheie

Caută unități de învățământ

Parametri

q query

string — Denumire (FTS + fuzzy)

judet query

string — Județ

tip query

string — Tip unitate (Liceu, Școală gimnazială...)

is_publica query

boolean — Publică / privată

limit query

integer — 1-100

cerere · curl

curl "https://api.arcadi.nexus/v1/unitati-invatamant?judet=Bra%C8%99ov&is_publica=true" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cod_siiir": "0000000001",
      "denumire_lunga": "LICEUL TEORETIC EXEMPLU",
      "tip": "Liceu",
      "judet": "Brașov",
      "localitate": "Brașov",
      "is_publica": true
    }
  ],
  "paginare": {
    "limit": 20,
    "offset": 0,
    "are_pagina_urmatoare": false,
    "total": null
  },
  "meta": {
    "versiune_api": "v1"
  }
}

Nomenclatoare

Tabele de referință — CAEN, județe, forme juridice, stări, calități. Cacheabile 24h.

GET /v1/nomenclatoare/caen cheie

Coduri CAEN (Rev.2 + Rev.3)

Parametri

versiune query

integer(2|3) — Filtrează revizia

q query

string — Caută în denumire/cod

limit query

integer — 1-500

cerere · curl

curl "https://api.arcadi.nexus/v1/nomenclatoare/caen?q=software&versiune=2" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cod": "6201",
      "versiune": 2,
      "denumire": "Activități de realizare a soft-ului la comandă",
      "cod_echivalent_alta_ver": "6201"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/nomenclatoare/caen/{cod} cheie

Un cod CAEN

Parametri

cod obligatoriu path

string — Cod CAEN

versiune query

integer(2|3) — Revizia (implicit ultima)

cerere · curl

curl "https://api.arcadi.nexus/v1/nomenclatoare/caen/6201" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "cod": "6201",
    "versiune": 2,
    "denumire": "Activități de realizare a soft-ului la comandă"
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/nomenclatoare/judete cheie

Județe

cerere · curl

curl "https://api.arcadi.nexus/v1/nomenclatoare/judete" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cod_auto": "CJ",
      "cod_statistic": "12",
      "denumire": "Cluj",
      "regiune": "Nord-Vest"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/nomenclatoare/forme-juridice cheie

Forme juridice

cerere · curl

curl "https://api.arcadi.nexus/v1/nomenclatoare/forme-juridice" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cod": "SRL",
      "denumire_completa": "Societate cu răspundere limitată",
      "tip_persoana": "PJ"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/nomenclatoare/stari cheie

Stări firmă

cerere · curl

curl "https://api.arcadi.nexus/v1/nomenclatoare/stari" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cod": 8,
      "denumire": "FUNCTIONARE"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/nomenclatoare/calitati cheie

Calități persoane (roluri)

cerere · curl

curl "https://api.arcadi.nexus/v1/nomenclatoare/calitati" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "cod": "ADM",
      "denumire": "administrator",
      "categorie": "conducere"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

Statistici

Agregări la nivel de țară, județ și CAEN + topuri — din materialized views, instant.

GET /v1/stats cheie

Statistici globale (contoare)

cerere · curl

curl "https://api.arcadi.nexus/v1/stats" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "firme_total": 3973230,
    "firme_active": 1988862,
    "firme_radiate": 1996311,
    "platitori_tva": 480114,
    "inactivi": 454635,
    "e_factura": 264735,
    "persoane": 2165643,
    "ong": 95635,
    "unitati_invatamant": 18022,
    "bilanturi": 11716925
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/stats/judete cheie

Sumar firme per județ

cerere · curl

curl "https://api.arcadi.nexus/v1/stats/judete" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "judet": "Cluj",
      "total": 198322,
      "active": 107827,
      "radiate": 90495,
      "plat_tva": 28000,
      "inactivi": 21000,
      "e_factura": 19000
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/stats/caen/{cod} cheie

Sumar financiar + contoare per CAEN

Parametri

cod obligatoriu path

string — Cod CAEN

cerere · curl

curl "https://api.arcadi.nexus/v1/stats/caen/6201" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "cod_caen": "6201",
    "denumire": "Activități de realizare a soft-ului la comandă",
    "firme_count": 17078,
    "total": 37825,
    "active": 30000,
    "cifra_total": 18161201805,
    "cifra_medie": 1063426.74,
    "profit_mediu": 109848.82,
    "salariati_mediu": 2.02,
    "firme_profitabile": 10064,
    "firme_in_pierdere": 7000
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/top-firme cheie

Top firme după cifră/profit/salariați

Top din clasamentul național (max 5000/an), opțional filtrat după CAEN și județ.

Parametri

an query

integer — Anul (2009-2024, implicit 2024)

cod_caen query

string — Filtru CAEN

judet query

string — Filtru județ

sort query

enum(cifra|profit|salariati) — Criteriu, implicit cifra

limit query

integer — 1-100

cerere · curl

curl "https://api.arcadi.nexus/v1/top-firme?an=2024&cod_caen=6201&sort=cifra&limit=10" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "rank_global": 1,
      "cui": 12345678,
      "denumire": "ACME PROD S.R.L.",
      "judet": "București",
      "cod_caen_principal": "6201",
      "cifra_afaceri_neta": 27800000000,
      "profit_net": 2100000000,
      "numar_mediu_salariati": 4800
    }
  ],
  "meta": {
    "an": 2024,
    "sort": "cifra",
    "versiune_api": "v1"
  }
}

Webhooks

Primește notificări semnate (HMAC-SHA256) când o firmă urmărită se modifică.

POST /v1/webhooks cheie

Înregistrează un webhook

Creează o subscripție. secret e afișat O SINGURĂ DATĂ — îl folosești pentru a verifica semnătura. Filtrează cu filter_cuis (firme urmărite) și filter_fields (câmpuri).

cerere · curl

curl -X POST "https://api.arcadi.nexus/v1/webhooks" \
  -H "X-API-Key: $NEXUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_url":"https://app-ul-tau.ro/webhooks/nexus","events":["company.changed"],"filter_cuis":[12345678],"filter_fields":["status_tva","denumire"]}'

răspuns · 200

{
  "data": {
    "id": 1,
    "target_url": "https://app-ul-tau.ro/webhooks/nexus",
    "events": [
      "company.changed"
    ],
    "filter_cuis": [
      12345678
    ],
    "filter_fields": [
      "status_tva",
      "denumire"
    ],
    "is_active": true,
    "created_at": "2026-05-26T10:00:00Z",
    "secret": "whsec_xxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/webhooks cheie

Listează webhook-urile cheii curente

cerere · curl

curl "https://api.arcadi.nexus/v1/webhooks" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "id": 1,
      "target_url": "https://app-ul-tau.ro/webhooks/nexus",
      "events": [
        "company.changed"
      ],
      "filter_cuis": [
        12345678
      ],
      "is_active": true,
      "last_delivery_at": "2026-05-26T10:05:00Z"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/webhooks/{id} cheie

Detaliu webhook

Parametri

id obligatoriu path

integer — ID webhook

cerere · curl

curl "https://api.arcadi.nexus/v1/webhooks/1" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "id": 1,
    "target_url": "https://app-ul-tau.ro/webhooks/nexus",
    "events": [
      "company.changed"
    ],
    "filter_cuis": [
      12345678
    ],
    "filter_fields": [
      "status_tva"
    ],
    "is_active": true
  },
  "meta": {
    "versiune_api": "v1"
  }
}

GET /v1/webhooks/{id}/livrari cheie

Istoric livrări

Parametri

id obligatoriu path

integer — ID webhook

limit query

integer — 1-200

cerere · curl

curl "https://api.arcadi.nexus/v1/webhooks/1/livrari" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": [
    {
      "id": 42,
      "event": "company.changed",
      "status": "delivered",
      "attempts": 1,
      "response_code": 200,
      "created_at": "2026-05-26T10:05:00Z"
    }
  ],
  "meta": {
    "versiune_api": "v1"
  }
}

DELETE /v1/webhooks/{id} cheie

Dezactivează un webhook

Parametri

id obligatoriu path

integer — ID webhook

cerere · curl

curl -X DELETE "https://api.arcadi.nexus/v1/webhooks/1" \
  -H "X-API-Key: $NEXUS_KEY"

răspuns · 200

{
  "data": {
    "id": 1,
    "dezactivat": true
  },
  "meta": {
    "versiune_api": "v1"
  }
}

API-ul NEXUS. Firmele României, prin cod.

Începe în 30 de secunde

Chei API

Limite per cheie

Format uniform

limit & offset

Verifică semnătura HMAC

Firme

Persoane

ONG-uri

Unități de învățământ

Nomenclatoare

Statistici

Webhooks

API-ul NEXUS.
Firmele României, prin cod.