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

# Trimite rezultatele prin e-mail

> Anunță clientul prin e-mail că rezultatele de laborator pentru kitul său de testare la domiciliu sunt gata

Trimite clientului un e-mail care îl anunță că rezultatele de laborator sunt gata. E-mailul este trimis la
adresa `email` a profilului comenzii de kit de testare la domiciliu.

E-mailul folosește brandingul generic al partenerului: numele și logo-ul grupului principal
de profiluri al profilului. Este în limba `language` a profilului, implicit engleză.

Setează `with_reports` la `true` pentru a atașa rapoartele de laborator ale kitului. E-mailul
atașează fiecare raport pe care clientul îl poate vedea în aplicație. Setează-l la `false` pentru
a trimite doar notificarea. Adaugă `note` pentru a afișa o notă personală în e-mail, de cel mult 1.000 de caractere.

Fiecare raport atașat este un PDF criptat cu AES-256. Parola este `date_of_birth` din
profil sub formă de 8 cifre, `DDMMYYYY`, fără puncte: un client născut pe 1 februarie 1985 tastează
`01021985`. E-mailul îi comunică clientului acest format, dar niciodată data nașterii în sine.

Fiecare apel trimite un e-mail. Apelurile nu sunt deduplicate: dacă apelezi endpointul de două ori, clientul
primește două e-mailuri.

E-mailul nu se trimite când:

* Nu a sosit încă niciun raport de laborator.
* Profilul nu are adresă de e-mail sau are doar o adresă provizorie `@aniva.email`.
* Profilul a dezactivat e-mailurile tranzacționale. Pentru a le reactiva, setează
  `transactional_emails_enabled` la `true` cu [Actualizare profil](https://docs.anivahealth.com/ro/api/profiles/update-profile.md).
* `with_reports` este `true`, iar profilul nu are `date_of_birth`. Seteaz-o cu
  [Actualizare profil](https://docs.anivahealth.com/ro/api/profiles/update-profile.md) sau trimite cu `with_reports: false`.
* Comanda este una dintre comenzile demo de kituri de testare la domiciliu. O comandă demo nu are un client căruia să îi trimiți e-mail.

Necesită scope-ul `results_view`, plus scope-ul `home_kit_orders_view` sau `home_kit_orders_manage`.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al comenzii de kit de testare la domiciliu pentru care trimiți rezultatele prin e-mail.

### Parametri de corp

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

`true` atașează rapoartele de laborator ca fișiere PDF protejate cu parolă. `false` trimite doar notificarea că rezultatele sunt
gata.

**note** `string`

O notă personală pe care e-mailul o afișează sub notificare. Cel mult 1.000 de caractere.

## Răspuns

La succes, API-ul returnează `200 OK`.

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

Adresa la care a fost trimis e-mailul: adresa `email` a profilului.

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

Numărul de rapoarte de laborator atașate. `0` când `with_reports` este `false`.

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

Momentul în care a fost trimis e-mailul, în format UTC (ISO 8601 cu sufixul `Z`).

## Răspunsuri de eroare

Corpul unei erori conține `error`, un mesaj lizibil, și `reason`, un cod stabil. Erorile de validare
și lipsa permisiunii `results_view` nu au `reason`.

| Status | Motiv | Descriere |
| - | - | - |
| `400` | — | Eroare de validare — ID invalid, lipsește `with_reports` sau `note` are mai mult de 1.000 de caractere. |
| `403` | `access_denied` | Interzis — cheia ta API nu are scope-urile necesare sau comanda de kit de testare la domiciliu este în afara contextului tău de acces. |
| `404` | `not_found` | Comanda de kit de testare la domiciliu nu a fost găsită. |
| `409` | `demo_order` | Comanda este o comandă demo de kit de testare la domiciliu. Nu are un client căruia să îi trimiți e-mail. |
| `409` | `no_reports` | Nu a sosit încă niciun raport de laborator. |
| `409` | `no_email` | Profilul nu are adresă de e-mail. |
| `409` | `placeholder_email` | Profilul are doar o adresă provizorie `@aniva.email`. Actualizează profilul cu o adresă de e-mail reală. |
| `409` | `unsubscribed` | Profilul a dezactivat e-mailurile tranzacționale. Setează mai întâi `transactional_emails_enabled` la `true`. |
| `409` | `no_birthdate` | `with_reports` este `true`, iar profilul nu are `date_of_birth`, parola PDF-ului. |
| `413` | `reports_too_large` | Rapoartele sunt prea mari pentru un singur e-mail. Trimite e-mailul cu `with_reports: false`. |
| `422` | `report_unprotectable` | Un raport nu este PDF sau nu a putut fi protejat cu parolă. Trimite cu `with_reports: false`. |
| `500` | — | Eroare internă de server. |
| `502` | `report_unavailable` | Un raport de laborator nu a putut fi încărcat. Nu s-a trimis niciun e-mail. |
| `502` | `send_failed` | Furnizorul de e-mail a refuzat e-mailul. Nu s-a trimis niciun e-mail. |

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