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

# Nosūtīt rezultātus e-pastā

> Nosūtīt klientam e-pastu, ka mājas testa komplekta laboratorijas rezultāti ir gatavi

Nosūti klientam vienu e-pastu, kas informē, ka viņa laboratorijas rezultāti ir gatavi. E-pasts tiek nosūtīts uz
mājas testa komplekta pasūtījuma profila `email`.

E-pastā izmantots vispārīgs partnera zīmola noformējums: profila galvenās profilu grupas
nosaukums un logotips. Tas ir profila `language` valodā, pēc noklusējuma angļu valodā.

Iestati `with_reports` uz `true`, lai pievienotu komplekta laboratorijas pārskatus. E-pastā
tiek pievienoti visi pārskati, kurus klients redz lietotnē. Iestati to uz `false`, lai
nosūtītu tikai paziņojumu. Pievieno `note`, lai e-pastā rādītu personisku piezīmi, ne vairāk kā 1 000 rakstzīmju.

Katrs pievienotais pārskats ir PDF fails, kas šifrēts ar AES-256. Parole ir profila `date_of_birth`
kā 8 cipari, `DDMMYYYY`, bez punktiem: klients, kurš dzimis 1985. gada 1. februārī, ievada
`01021985`. E-pastā klientam ir norādīts šis formāts, bet nekad pats dzimšanas datums.

Katrs izsaukums nosūta vienu e-pastu. Izsaukumi netiek deduplicēti: ja izsauc galapunktu divreiz, klients
saņem divus e-pastus.

E-pasts netiek nosūtīts, ja:

* Vēl nav saņemts neviens laboratorijas pārskats.
* Profilā nav e-pasta adreses vai ir tikai pagaidu `@aniva.email` adrese.
* Profilā ir izslēgti transakciju e-pasti. Lai tos atkal ieslēgtu, iestati
  `transactional_emails_enabled` uz `true`, izmantojot [Atjaunināt profilu](https://docs.anivahealth.com/lv/api/profiles/update-profile.md).
* `with_reports` ir `true`, un profilā nav `date_of_birth`. Iestati to ar
  [Atjaunināt profilu](https://docs.anivahealth.com/lv/api/profiles/update-profile.md) vai nosūti ar `with_reports: false`.
* Pasūtījums ir viens no demo mājas testa komplektu pasūtījumiem. Demo pasūtījumam nav klienta, kam nosūtīt e-pastu.

Nepieciešams `results_view` tvērums, kā arī `home_kit_orders_view` vai `home_kit_orders_manage` tvērums.

## Pieprasījums

### Ceļa parametri

**id** `string` *required*

Unikāls identifikators (UUID) mājas testa komplekta pasūtījumam, kura rezultātus nosūtīt e-pastā.

### Pieprasījuma satura parametri

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

`true` pievieno laboratorijas pārskatus kā ar paroli aizsargātus PDF failus. `false` nosūta tikai paziņojumu, ka rezultāti ir
gatavi.

**note** `string`

Personīga piezīme, ko e-pasts parāda zem paziņojuma. Ne vairāk kā 1 000 rakstzīmju.

## Atbilde

Veiksmes gadījumā API atgriež `200 OK`.

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

Adrese, uz kuru e-pasts tika nosūtīts: profila `email`.

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

Pievienoto laboratorijas pārskatu skaits. `0`, ja `with_reports` ir `false`.

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

Laiks, kad e-pasts tika nosūtīts, kā UTC laika punkts (ISO 8601 ar `Z` sufiksu).

## Kļūdu atbildes

Kļūdas atbildes saturā ir `error` (cilvēkam lasāms ziņojums) un `reason` (stabils kods). Validācijas kļūdām
un trūkstošam `results_view` tvērumam nav `reason`.

| Statuss | Iemesls | Apraksts |
| - | - | - |
| `400` | — | Validācijas kļūda — nederīgs ID, trūkst `with_reports`, vai `note` ir garāka par 1 000 rakstzīmēm. |
| `403` | `access_denied` | Aizliegts — tavai API atslēgai nav nepieciešamo tvērumu, vai mājas testa komplekta pasūtījums ir ārpus tava piekļuves konteksta. |
| `404` | `not_found` | Mājas testa komplekta pasūtījums nav atrasts. |
| `409` | `demo_order` | Pasūtījums ir demo mājas testa komplekta pasūtījums. Tam nav klienta, kam nosūtīt e-pastu. |
| `409` | `no_reports` | Vēl nav saņemts neviens laboratorijas pārskats. |
| `409` | `no_email` | Profilā nav e-pasta adreses. |
| `409` | `placeholder_email` | Profilā ir tikai pagaidu `@aniva.email` adrese. Atjaunini profilu ar īstu e-pasta adresi. |
| `409` | `unsubscribed` | Profilā ir izslēgti transakciju e-pasti. Vispirms iestati `transactional_emails_enabled` uz `true`. |
| `409` | `no_birthdate` | `with_reports` ir `true`, un profilā nav `date_of_birth`, kas ir PDF parole. |
| `413` | `reports_too_large` | Pārskati ir pārāk lieli vienam e-pastam. Nosūti e-pastu ar `with_reports: false`. |
| `422` | `report_unprotectable` | Pārskats nav PDF fails vai to nevarēja aizsargāt ar paroli. Nosūti ar `with_reports: false`. |
| `500` | — | Iekšēja servera kļūda. |
| `502` | `report_unavailable` | Neizdevās ielādēt laboratorijas pārskatu. E-pasts netika nosūtīts. |
| `502` | `send_failed` | E-pasta pakalpojumu sniedzējs noraidīja e-pastu. E-pasts netika nosūtīts. |

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