---
title: "Vyhledání osob podle jména"
method: GET
path: "/api/v1/osoby"
---

# Vyhledání osob podle jména

`GET /api/v1/osoby`

## Request

- Base URL: `https://firmastat.cz`
- URL: `https://firmastat.cz/api/v1/osoby`
- Auth: one of:
  - none
  - HTTP bearer

Fyzické osoby z obchodního rejstříku (statutáři, společníci…). Na diakritice ani velikosti písmen nezáleží. Vrací klíč profilu, podle kterého lze načíst detail přes /api/v1/osoba/{klic}.

## Query parameters

- `q` string, required
- `start` integer
- `pocet` integer

## Response `200`

Stránka nalezených osob

## Other responses

- `400`: Příliš krátký dotaz nebo překročený strop parametru
- `401`: Neplatný nebo zneplatněný API klíč.
- `429`: Vyčerpaný limit: bez přihlášení 30 dotazů/den na IP, s účtem měsíční kvóta tarifu (Free 500/měs).

---

[API](https://skmtc.dev/firmastat/apis/firmastat-api.md) · [All operations](https://skmtc.dev/firmastat/apis/firmastat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firmastat/apis/firmastat-api/revisions/b1bdf909e040?raw)