Endpointsv1companies/autocomplete

GET /v1/companies/autocomplete

Caută companii în timp real folosind autocomplete. Ideal pentru interfețe de tip typeahead.

Parametri

  • q: text de căutat (minim 3 caractere, obligatoriu)
    • Caută în denumirea companiei, CUI (cod unic de înregistrare) și numărul de înregistrare la Registrul Comerțului
    • Suportă căutare parțială - rezultatele se potrivesc dacă conțin textul căutat
    • Rezultatele sunt ordonate după relevanță (companiile cu CUI/denumire exactă apar primele)
Exemplu căutare după denumire
GET https://api.targetare.ro/v1/companies/autocomplete?q=rompetrol
Authorization: Bearer ZXlKaGJHY2lPaUprYVhJ...diLWJlMTAtODA4NjFhOTdmY2Q
Exemplu căutare după CUI
GET https://api.targetare.ro/v1/companies/autocomplete?q=1860712
Authorization: Bearer ZXlKaGJHY2lPaUprYVhJ...diLWJlMTAtODA4NjFhOTdmY2Q
Raspuns
{
  "success": true,
  "remainingRequests": 4999,
  "data": [
    {
      "taxId": "1860712",
      "companyId": "J13/534/1991",
      "companyName": "ROMPETROL RAFINARE SA",
      "companyType": "SA",
      "status": "functiune",
      "locality": "Navodari",
      "county": "Constanta"
    },
    {
      "taxId": "14399840",
      "companyId": "J40/7442/2001",
      "companyName": "VODAFONE ROMANIA SA",
      "companyType": "SA",
      "status": "functiune",
      "locality": "Sector 1",
      "county": "Bucuresti"
    }
  ]
}

Câmpuri Răspuns

CâmpTipDescriere
taxIdstringCodul unic de înregistrare (CUI)
companyIdstringNumărul de înregistrare la Registrul Comerțului
companyNamestringDenumirea companiei
companyTypestringForma juridică (SRL, SA, PFA, etc.)
statusstringStarea companiei (functiune, dizolvata, radiere, etc.)
localitystringLocalitatea sediului social
countystringJudețul sediului social

Note importante

  • Endpoint-ul returnează maximum 10 rezultate, sortate după relevanță
  • Lungime minimă: 3 caractere
  • Câmpuri în care se caută:
    • Denumirea companiei (ex: “rompetrol”, “vodafone”, “sc”)
    • CUI - Cod Unic de Înregistrare (ex: “1860712”, “14399840”)
    • Număr de înregistrare la Registrul Comerțului (ex: “J13/534/1991”, “J40”)
  • Prioritizare rezultate (în ordine descrescătoare):
    1. Potrivire exactă la început de denumire
    2. Potrivire exactă CUI sau număr înregistrare
    3. Potrivire parțială în denumire