---
title: "Caută firme după nume (fără credit)"
method: GET
path: "/api/v1/search"
tags: ["Firme (gratuit)"]
---

# Caută firme după nume (fără credit)

`GET /api/v1/search`

## Request

- Base URL: `https://firmoscop.ro`
- URL: `https://firmoscop.ro/api/v1/search`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `fs_session`

## Query parameters

- `q` string, required

## Response `200`

Candidați potriviți pe nume.

- object
  - `query` string
  - `hits` SearchHit[]
    - `cui` string
    - `name` string
    - `county` string, nullable
    - `locality` string, nullable
    - `registrationState` string, nullable
    - `similarity` number

## Other responses

- `400`: Eroare — corp JSON { error, message } în limbaj natural.
- `401`: Eroare — corp JSON { error, message } în limbaj natural.
- `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)