> ## 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.

# Odeslat výsledky e-mailem

> Odeslat zákazníkovi e-mail, že má připravené laboratorní výsledky

Pošli zákazníkovi jeden e-mail s informací, že má laboratorní výsledky připravené. E-mail se odešle na adresu
`email` v profilu daného termínu.

E-mail používá obecný partnerský branding: název a logo primární profilové
skupiny profilu. Je v jazyce `language` profilu, výchozí je angličtina.

Nastav `with_reports` na `true`, pokud chceš přiložit laboratorní zprávy k termínu. E-mail
přiloží každou zprávu, kterou zákazník vidí v aplikaci. Nastavením na `false`
odešleš jen oznámení. Přidej `note` pro zobrazení osobní poznámky v e-mailu, maximálně 1 000 znaků.

Každá přiložená zpráva je PDF zašifrované pomocí AES-256. Heslem je `date_of_birth` z
profilu jako 8 číslic ve formátu `DDMMYYYY` bez teček: zákazník narozený 1. února 1985 zadá
`01021985`. E-mail zákazníkovi tento formát sdělí, ale nikdy samotné datum narození.

Každé volání odešle jeden e-mail. Volání se nededuplikují: když endpoint zavoláš dvakrát, zákazník
dostane dva e-maily.

E-mail se neodešle, když:

* Zatím nedorazila žádná laboratorní zpráva.
* Profil nemá žádnou e-mailovou adresu, nebo má jen zástupnou adresu `@aniva.email`.
* Profil má vypnuté transakční e-maily. Pokud je chceš znovu zapnout, nastav
  `transactional_emails_enabled` na `true` přes [Aktualizovat profil](https://docs.anivahealth.com/cs/api/profiles/update-profile.md).
* Hodnota `with_reports` je `true` a profil nemá vyplněné `date_of_birth`. Nastav ho přes
  [Aktualizovat profil](https://docs.anivahealth.com/cs/api/profiles/update-profile.md), nebo odešli požadavek s `with_reports: false`.

Vyžaduje scope `results_view`.

## Požadavek

### Parametry cesty

**id** `string` *required*

Jedinečný identifikátor (UUID) termínu, jehož výsledky chceš poslat e-mailem.

### Parametry těla

**with\_reports** `boolean` *required*

`true` přiloží laboratorní zprávy jako PDF soubory chráněné heslem. `false` odešle jen oznámení, že jsou výsledky
připravené.

**note** `string`

Osobní poznámka, která se v e-mailu zobrazí pod oznámením. Maximálně 1 000 znaků.

## Odpověď

Při úspěchu vrátí API `200 OK`.

**recipient\_email** `string` *required*

Adresa, na kterou se e-mail odeslal: `email` profilu.

**attachment\_count** `integer` *required*

Počet přiložených laboratorních zpráv. `0`, když je `with_reports` nastaveno na `false`.

**sent\_at** `string` *required*

Čas odeslání e-mailu jako okamžik v UTC (ISO 8601 s příponou `Z`).

## Chybové odpovědi

Tělo chyby obsahuje `error`, srozumitelnou zprávu, a `reason`, stabilní kód. Chyby validace
a chybějící scope `results_view` pole `reason` nemají.

| Stav | Důvod | Popis |
| - | - | - |
| `400` | — | Chyba validace — neplatné ID, chybějící `with_reports` nebo `note` delší než 1 000 znaků. |
| `403` | `access_denied` | Zakázáno — tvůj API klíč nemá tento scope, nebo je termín mimo tvůj přístupový kontext. |
| `404` | `not_found` | Termín nebyl nalezen. |
| `409` | `no_reports` | Zatím nedorazila žádná laboratorní zpráva. |
| `409` | `no_email` | Profil nemá žádnou e-mailovou adresu. |
| `409` | `placeholder_email` | Profil má jen zástupnou adresu `@aniva.email`. Aktualizuj profil skutečným e-mailem. |
| `409` | `unsubscribed` | Profil má vypnuté transakční e-maily. Nejdřív nastav `transactional_emails_enabled` na `true`. |
| `409` | `no_birthdate` | `with_reports` je `true` a profil nemá `date_of_birth`, které slouží jako heslo k PDF. |
| `413` | `reports_too_large` | Zprávy jsou na jeden e-mail příliš velké. Odešli e-mail s `with_reports: false`. |
| `422` | `report_unprotectable` | Zpráva není PDF nebo ji nešlo zaheslovat. Odešli s `with_reports: false`. |
| `500` | — | Interní chyba serveru. |
| `502` | `report_unavailable` | Laboratorní zprávu se nepodařilo načíst. Žádný e-mail se neodeslal. |
| `502` | `send_failed` | Poskytovatel e-mailu zprávu odmítl. Žádný e-mail se neodeslal. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/results/email \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "with_reports": true,
    "note": "Your vitamin D is low. We will talk about it at your next visit."
  }'
```

```json 200 theme={null}
{
  "recipient_email": "maria.schmidt@example.com",
  "attachment_count": 1,
  "sent_at": "2026-10-15T09:12:44.512Z"
}
```

```json 409 theme={null}
{
  "error": "This customer has turned off emails. Turn emails on for them first.",
  "reason": "unsubscribed"
}
```


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