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

# Envia els resultats per correu electrònic

> Avisa el client per correu electrònic que els seus resultats de laboratori estan a punt

Envia al client un correu electrònic per avisar-lo que els seus resultats de laboratori estan a punt. El correu s'envia a
l'`email` del perfil de la cita.

El correu electrònic fa servir la marca genèrica del soci: el nom i el logotip del grup de
perfils principal del perfil. És en el `language` del perfil, en anglès per defecte.

Defineix `with_reports` com a `true` per adjuntar els informes de laboratori de la cita. El correu
adjunta tots els informes que el client pot veure a l'app. Defineix-lo com a `false`
per enviar només l'avís. Afegeix `note` per mostrar una nota personal al correu, de com a màxim 1.000 caràcters.

Cada informe adjunt és un PDF xifrat amb AES-256. La contrasenya és el camp `date_of_birth` del
perfil en 8 dígits, `DDMMYYYY`, sense punts: un client nascut l'1 de febrer de 1985 escriu
`01021985`. El correu indica aquest format al client, però mai la data de naixement en si.

Cada crida envia un correu electrònic. Les crides no es dedupliquen: si crides l'endpoint dues vegades, el client
rep dos correus electrònics.

El correu electrònic no s'envia quan:

* Encara no ha arribat cap informe de laboratori.
* El perfil no té adreça electrònica o només té una adreça provisional `@aniva.email`.
* El perfil ha desactivat els correus transaccionals. Per tornar-los a activar, defineix
  `transactional_emails_enabled` com a `true` amb [Actualitza el perfil](https://docs.anivahealth.com/ca/api/profiles/update-profile.md).
* `with_reports` és `true` i el perfil no té `date_of_birth`. Defineix-la amb
  [Actualitza el perfil](https://docs.anivahealth.com/ca/api/profiles/update-profile.md), o envia'l amb `with_reports: false`.

Requereix l'àmbit `results_view`.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

Identificador únic (UUID) de la cita de la qual s'envien els resultats per correu.

### Paràmetres del cos

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

`true` adjunta els informes de laboratori com a fitxers PDF protegits amb contrasenya. `false` envia només l'avís que els resultats estan
a punt.

**note** `string`

Una nota personal que el correu mostra a sota de l'avís. Com a màxim 1.000 caràcters.

## Resposta

En cas d'èxit, l'API retorna `200 OK`.

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

L'adreça a la qual s'ha enviat el correu: l'`email` del perfil.

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

El nombre d'informes de laboratori adjunts. `0` quan `with_reports` és `false`.

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

Quan s'ha enviat el correu, com a instant UTC (ISO 8601 amb el sufix `Z`).

## Respostes d'error

El cos d'un error conté `error`, un missatge llegible per a humans, i `reason`, un codi estable. Els errors de validació
i la falta de l'àmbit `results_view` no tenen `reason`.

| Estat | Motiu | Descripció |
| - | - | - |
| `400` | — | Error de validació — ID no vàlid, falta `with_reports` o `note` supera els 1.000 caràcters. |
| `403` | `access_denied` | Prohibit — la teva clau API no té l'àmbit o la cita queda fora del teu context d'accés. |
| `404` | `not_found` | No s'ha trobat la cita. |
| `409` | `no_reports` | Encara no ha arribat cap informe de laboratori. |
| `409` | `no_email` | El perfil no té adreça electrònica. |
| `409` | `placeholder_email` | El perfil només té una adreça provisional `@aniva.email`. Actualitza el perfil amb un correu real. |
| `409` | `unsubscribed` | El perfil ha desactivat els correus transaccionals. Defineix primer `transactional_emails_enabled` com a `true`. |
| `409` | `no_birthdate` | `with_reports` és `true` i el perfil no té `date_of_birth`, la contrasenya del PDF. |
| `413` | `reports_too_large` | Els informes són massa grans per a un sol correu. Envia el correu amb `with_reports: false`. |
| `422` | `report_unprotectable` | Un informe no és un PDF o no s'ha pogut protegir amb contrasenya. Envia'l amb `with_reports: false`. |
| `500` | — | Error intern del servidor. |
| `502` | `report_unavailable` | No s'ha pogut carregar un informe de laboratori. No s'ha enviat cap correu. |
| `502` | `send_failed` | El proveïdor de correu ha rebutjat el missatge. No s'ha enviat cap correu. |

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