> ## 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 sale de laborator sunt gata

Trimite clientului un e-mail care îl anunță că rezultatele de laborator sunt gata. E-mailul ajunge la
adresa `email` a profilului programării.

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 programării. 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 ajuns încă niciun raport de laborator.
* Profilul nu are adresă de e-mail sau are doar o adresă provizorie `@aniva.email`.
* Profilul are dezactivate e-mailurile tranzacționale. Pentru a le reactiva, setează
  `transactional_emails_enabled` la `true` prin [Actualizează profilul](https://docs.anivahealth.com/ro/api/profiles/update-profile.md).
* `with_reports` este `true`, iar profilul nu are `date_of_birth`. Setează valoarea prin
  [Actualizează profilul](https://docs.anivahealth.com/ro/api/profiles/update-profile.md) sau trimite cu `with_reports: false`.

Necesită permisiunea `results_view`.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al programării 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, `with_reports` lipsește sau `note` depășește 1.000 de caractere. |
| `403` | `access_denied` | Interzis — cheia ta API nu are permisiunea necesară sau programarea este în afara contextului tău de acces. |
| `404` | `not_found` | Programarea nu a fost găsită. |
| `409` | `no_reports` | Nu a ajuns î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ă reală de e-mail. |
| `409` | `unsubscribed` | Profilul are dezactivate 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/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.