---
title: "Sugestii publice după nume (fără cont, limitat pe IP)"
method: GET
path: "/api/v1/suggest"
tags: ["Firme (gratuit)"]
---

# Sugestii publice după nume (fără cont, limitat pe IP)

`GET /api/v1/suggest`

## Request

- Base URL: `https://firmoscop.ro`
- URL: `https://firmoscop.ro/api/v1/suggest`
- Auth: none declared

Câmpuri minime, pentru autocomplete public. Pentru integrare folosește /api/v1/search cu cheie.

## Query parameters

- `q` string, required

## Response `200`

Până la 10 sugestii.

- object
  - `query` string
  - `hits` SuggestHit[]
    - `cui` string
    - `name` string
    - `county` string, nullable
    - `locality` string, nullable
    - `registrationState` string, nullable
    - `similarity` number
    - `stateBadge` object, nullable: Starea din registru, gata de afișat. null = firmă în funcțiune. Roșu = firma a încetat să existe (radiată, dizolvată); galben = firma există, dar are o stare care cere atenție (de ex. o procedură de insolvență).
      - `label` string
      - `tone` 'rosu' | 'galben'

## Other responses

- `429`: Eroare — corp JSON { error, message } în limbaj natural.

---

[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)