> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vypsat profily

> Vypsat nebo vyhledat profily pacientů podle e-mailu

Vypiš profily pacientů dostupné pro tvůj API klíč, nebo jeden vyhledej podle přesné e-mailové adresy.

Když zadáš `email`, endpoint provede přesné vyhledání kešované v Redisu podle
kanonického přihlašovacího e-mailu a vrátí 0 nebo 1 výsledek; `limit` a `offset` se v tom
případě ignorují. Když ho vynecháš, endpoint vrátí stránkovaný seznam profilů v kontextu přístupu tvého API
klíče.

Porovnávání e-mailů nerozlišuje velikost písmen a vyžaduje přesnou shodu — shody podřetězců a prefixů nejsou podporovány.
Kontroluje se jen kanonický přihlašovací e-mail; alternativní adresy jako `work_email` se
nezohledňují.

Vyžaduje scope `profiles_view` nebo `impersonate`.

## Požadavek

### Parametry dotazu

**email** `string`

Filtr podle přesné e-mailové adresy (nerozlišuje velikost písmen). Když je nastavený, vrátí 0 nebo 1 výsledek a
`limit`/`offset` se ignorují. Vyhledávání zajišťuje reverzní index kešovaný v Redisu s
indexovaným SQL fallbackem.

**limit** `integer` (default: 100)

Maximální počet vrácených profilů. Výchozí hodnota je 100, maximum 500. Ignoruje se, když je nastavený `email`.

**offset** `integer` (default: 0)

Počet profilů k přeskočení při stránkování. Výchozí hodnota je 0. Ignoruje se, když je nastavený `email`.

## Odpověď

Při úspěchu vrátí API `200 OK` s polem objektů profilů. Struktura každé
položky odpovídá [Načtení profilu](https://docs.anivahealth.com/cs/api/profiles/get-profile.md).

**id** `string` *required*

Jedinečný identifikátor profilu (UUID).

**handle** `string`

Handle nebo uživatelské jméno profilu. Může být `null`.

**first\_name** `string`

Křestní jméno. Může být `null`.

**last\_name** `string`

Příjmení. Může být `null`.

**email** `string`

E-mailová adresa. Může být `null`.

**phone** `string`

Telefonní číslo ve formátu E.164. Může být `null`.

**sex** `integer`

Biologické pohlaví podle ISO/IEC 5218 (`0` = neznámé, `1` = muž, `2` = žena). Může být `null`.

**date\_of\_birth** `string`

Datum narození ve formátu `YYYY-MM-DD`. Může být `null`.

**height** `number`

Výška v centimetrech. Může být `null`.

**weight** `number`

Hmotnost v kilogramech. Může být `null`.

**language** `string`

Preferovaný jazyk: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` nebo `uk`.

**transactional\_emails\_enabled** `boolean`

Zda tento profil přijímá transakční (automatické) e-maily. `null`, pokud nebylo nikdy nastaveno.

**created\_at** `string`

Časové razítko ISO 8601 vytvoření profilu.

**updated\_at** `string`

Časové razítko ISO 8601 poslední aktualizace. Může být `null`.

## Poznámky k chování

* Prázdné pole se vrátí jak tehdy, když e-mailu neodpovídá žádný profil, tak když shoda existuje
  mimo tvůj kontext přístupu. Je to záměrné — brání to endpointu prozradit
  existenci profilů, které nemůžeš číst.
* Nově vytvořené profily lze okamžitě dohledat podle `email`, protože proces vytvoření
  synchronně naplní cache.
* Nefiltrovaný seznam je seřazený podle `created_at` sestupně (od nejnovějších) a stránkovaný přes
  `limit` a `offset`.

## Opakovaná volání

Aniva ukládá odpověď tohoto endpointu po dobu 5 minut pro každý API klíč. Opakované volání v tomto
čase dostane uloženou odpověď. Hlavičky `Cache-Status` a `Age` ukazují, že je odpověď
uložená a jak je stará.

Pokud se chceš o změně dozvědět hned, přihlas se k odběru webhook událostí `profile.created`, `profile.updated` a `profile.deleted`.
Viz [Opakovaná čtení](https://docs.anivahealth.com/cs/concepts/webhooks.md#opakovana-cteni).

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Chyba validace — neplatný formát e-mailu nebo `limit`/`offset` mimo rozsah. |
| `403` | Zakázáno — tvůj API klíč nemá požadovaný scope (`profiles_view`/`impersonate`). |
| `500` | Interní chyba serveru. |

```bash cURL (lookup by email) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/profiles?email=maria.schmidt@example.com' \
  --header 'x-api-key: YOUR_API_KEY'
```

```bash cURL (paginated list) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/profiles?limit=50&offset=0' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
[
  {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": "2026-04-01T11:05:00Z"
  }
]
```

```json 200 (no match) theme={null}
[]
```

```json 400 theme={null}
{
  "error": "email: Invalid email format"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.