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

# Wyślij wyniki e-mailem

> Powiadom klienta e-mailem, że wyniki laboratoryjne z jego domowego zestawu testowego są gotowe

Wyślij klientowi jednego e-maila z informacją, że wyniki laboratoryjne są gotowe. Wiadomość trafia na
`email` z profilu zamówienia domowego zestawu testowego.

E-mail korzysta z ogólnego brandingu partnera: nazwy i logo głównej grupy profili
tego profilu. Jest w języku `language` profilu, domyślnie po angielsku.

Ustaw `with_reports` na `true`, aby załączyć raporty laboratoryjne zestawu. W e-mailu
załączony jest każdy raport, który klient widzi w aplikacji. Ustaw `false`, aby
wysłać tylko powiadomienie. Dodaj `note`, aby wyświetlić w e-mailu osobistą notatkę, maksymalnie 1 000 znaków.

Każdy załączony raport to plik PDF zaszyfrowany algorytmem AES-256. Hasłem jest pole `date_of_birth`
profilu jako 8 cyfr, `DDMMYYYY`, bez kropek: klient urodzony 1 lutego 1985 wpisuje
`01021985`. E-mail podaje klientowi ten format, ale nigdy samej daty urodzenia.

Każde wywołanie wysyła jeden e-mail. Wywołania nie są deduplikowane: jeśli wywołasz endpoint dwa razy, klient
dostanie dwa e-maile.

E-mail nie jest wysyłany, gdy:

* Żaden raport laboratoryjny jeszcze nie dotarł.
* Profil nie ma adresu e-mail lub ma tylko zastępczy adres `@aniva.email`.
* W profilu wyłączono e-maile transakcyjne. Aby włączyć je ponownie, ustaw
  `transactional_emails_enabled` na `true` za pomocą [Zaktualizuj profil](https://docs.anivahealth.com/pl/api/profiles/update-profile.md).
* `with_reports` ma wartość `true`, a profil nie ma pola `date_of_birth`. Ustaw je za pomocą
  [Zaktualizuj profil](https://docs.anivahealth.com/pl/api/profiles/update-profile.md) lub wyślij z `with_reports: false`.
* Zamówienie jest jednym z demonstracyjnych zamówień domowego zestawu testowego. Zamówienie demonstracyjne nie ma klienta, do którego można wysłać e-mail.

Wymaga zakresu `results_view` oraz zakresu `home_kit_orders_view` lub `home_kit_orders_manage`.

## Żądanie

### Parametry ścieżki

**id** `string` *required*

Unikalny identyfikator (UUID) zamówienia domowego zestawu testowego, którego wyniki chcesz wysłać e-mailem.

### Parametry treści

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

`true` dołącza raporty laboratoryjne jako pliki PDF chronione hasłem. `false` wysyła tylko powiadomienie, że wyniki są
gotowe.

**note** `string`

Osobista wiadomość wyświetlana w e-mailu pod powiadomieniem. Maksymalnie 1 000 znaków.

## Odpowiedź

W razie powodzenia API zwraca `200 OK`.

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

Adres, na który wysłano e-mail: pole `email` profilu.

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

Liczba załączonych raportów laboratoryjnych. `0`, gdy `with_reports` ma wartość `false`.

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

Czas wysłania e-maila jako znacznik UTC (ISO 8601 z sufiksem `Z`).

## Odpowiedzi z błędami

Treść błędu zawiera pole `error` z czytelnym komunikatem oraz `reason` ze stałym kodem. Błędy walidacji
i brak zakresu `results_view` nie mają pola `reason`.

| Status | Powód | Opis |
| - | - | - |
| `400` | — | Błąd walidacji — nieprawidłowe ID, brak `with_reports` lub `note` dłuższe niż 1 000 znaków. |
| `403` | `access_denied` | Brak dostępu — twój klucz API nie ma wymaganych zakresów lub zamówienie domowego zestawu testowego jest poza twoim kontekstem dostępu. |
| `404` | `not_found` | Nie znaleziono zamówienia domowego zestawu testowego. |
| `409` | `demo_order` | Zamówienie jest demonstracyjnym zamówieniem domowego zestawu testowego. Nie ma klienta, do którego można wysłać e-mail. |
| `409` | `no_reports` | Żaden raport laboratoryjny jeszcze nie dotarł. |
| `409` | `no_email` | Profil nie ma adresu e-mail. |
| `409` | `placeholder_email` | Profil ma tylko zastępczy adres `@aniva.email`. Zaktualizuj profil, podając prawdziwy adres e-mail. |
| `409` | `unsubscribed` | W profilu wyłączono e-maile transakcyjne. Najpierw ustaw `transactional_emails_enabled` na `true`. |
| `409` | `no_birthdate` | `with_reports` ma wartość `true`, a profil nie ma pola `date_of_birth`, które służy jako hasło do PDF. |
| `413` | `reports_too_large` | Raporty są za duże na jeden e-mail. Wyślij e-mail z `with_reports: false`. |
| `422` | `report_unprotectable` | Raport nie jest plikiem PDF lub nie udało się zabezpieczyć go hasłem. Wyślij z `with_reports: false`. |
| `500` | — | Wewnętrzny błąd serwera. |
| `502` | `report_unavailable` | Nie udało się wczytać raportu laboratoryjnego. Nie wysłano żadnego e-maila. |
| `502` | `send_failed` | Dostawca poczty odrzucił wiadomość. Nie wysłano żadnego e-maila. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results/email \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "with_reports": true
  }'
```

```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": "No lab report has arrived yet.",
  "reason": "no_reports"
}
```


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