# Vyhľadávanie subjektov

Tento endpoint použite, keď potrebujete dohľadať údaje o firme alebo živnostníkovi podľa názvu či IČO.

Endpoint: GET /subjects
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `searchQuery` (string, required)
    Hľadaný reťazec. Môže to byť názov subjektu alebo IČO. Minimum sú 3 znaky.
    Example: "acme"

  - `legalForm` (string)
    Voliteľný filter podľa právnej formy, ak chcete výsledky zúžiť len na firmy alebo živnostníkov.
    Enum: "freelancer", "company"

  - `limit` (integer)
    Maximálny počet výsledkov, ktoré endpoint vráti.
    Example: 5

## Response 200 fields (application/json):

  - `data` (array)
    Zoznam nájdených subjektov.

  - `data.id` (integer)
    IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu zvyčajne viete nájsť aj cez referenčný register subjektov.
    Example: 12345678

  - `data.name` (string)
    Obchodné meno alebo názov subjektu.
    Example: "Acme s.r.o."

  - `data.taxId` (string,null)
    DIČ subjektu, ak je dostupné.
    Example: "2020123456"

  - `data.vatId` (string,null)
    IČ DPH subjektu, ak je dostupné.
    Example: "SK2020123456"

  - `data.legalForm` (string)
    Právna forma subjektu.
    Enum: "freelancer", "company"

  - `data.city` (string,null)
    Mesto sídla alebo miesta podnikania.
    Example: "Bratislava"

  - `data.street` (string,null)
    Ulica a číslo sídla alebo miesta podnikania.
    Example: "Hlavná 1"

  - `data.zip` (string,null)
    PSČ sídla alebo miesta podnikania.
    Example: "81101"

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Server Error"

## Response 503 fields (application/json):

  - `message` (string)
    Example: "Service Unavailable"