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

# Obține comanda de kit de testare la domiciliu

> Preia un kit de testare la domiciliu trimis prin poștă după ID

Obține o singură comandă de kit de testare la domiciliu după UUID-ul ei, inclusiv profilul integrat al pacientului. Folosește acest endpoint pentru a verifica statusul comenzii, a consulta adresa de livrare sau a inspecta panelurile și biomarkerii atașați.

Necesită 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 de obținut.

## Răspuns

În caz de succes, API-ul returnează `200 OK` cu comanda de kit de testare la domiciliu și profilul ei integrat.

**id** `string` *required*

Identificatorul unic (UUID) al comenzii de kit de testare la domiciliu.

**profile\_id** `string` *required*

UUID-ul profilului căruia îi aparține această comandă de kit de testare la domiciliu.

**status** `string` *required*

Statusul actual al comenzii de kit de testare la domiciliu. Una dintre valorile `pending`, `dispatched`, `activated` sau `cancelled`.
Gradul de finalizare a rezultatelor de laborator se obține din [Obținere rezultate](https://docs.anivahealth.com/ro/api/home-kit-orders/get-results.md).

**delivery\_address** `object` *required*

Adresa la care se trimite kitul — în una dintre două forme: fie `{ location_id }` cu referire la o locație de testare cunoscută, fie câmpurile de adresă inline (`name`, `street`, `city`, `postal_code`, `country_code`; `company_name` / `house_number` / `address_line_2` / `state` / `phone` / `email` opționale — același vocabular ca în API-ul de locații). Furnizează exact una dintre ele — o referință de locație sau o adresă inline, nu ambele.

**adresa de livrare**

> [tab] Referință de locație
>
> **location\_id** `string` *required*
>
> UUID-ul locației de testare la care se expediază kitul.

> [tab] Adresă inline
>
> **name** `string` *required*
>
> Numele destinatarului, al companiei sau al locației.
>
> **company\_name** `string`
>
> Compania care păstrează coletul pentru destinatar — o parte `c/o` sau un departament.
>
> **street** `string` *required*
>
> Numele străzii, fără număr (de ex. `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Numărul casei (de ex. `118` sau `12a`).
>
> **address\_line\_2** `string`
>
> Clădire, scară sau etaj.
>
> **city** `string` *required*
>
> **state** `string`
>
> Stat sau provincie. Opțional.
>
> **postal\_code** `string` *required*
>
> **country\_code** `string` *required*
>
> Cod ISO 3166-1 alpha-2 (două litere, de ex. `DE`).
>
> **phone** `string`
>
> **email** `string`

**lab\_code** `string`

Codul de probă de laborator sub care sunt raportate rezultatele — tipărit pe kitul fizic, pe care
pacientul îl citește de pe cutie ca cod de activare. `null` până când kitul este ambalat.
Doar citire.

**activated\_at** `string` *required*

Marcajul temporal al recoltării raportat prin [Activează](https://docs.anivahealth.com/ro/api/home-kit-orders/activate-home-kit.md) — momentul în care
pacientul și-a recoltat proba. `null` până când kitul este activat.

**replaces\_home\_kit\_order\_id** `string`

Comanda de kit de testare la domiciliu pe care o înlocuiește aceasta, când este un kit de înlocuire. `null` pentru o comandă obișnuită. Vezi
[Creează comandă de kit de testare la domiciliu](https://docs.anivahealth.com/ro/api/home-kit-orders/create-home-kit.md).

**replacement\_reason** `string`

Motivul pentru care a fost trimis kitul de înlocuire. `null` pentru o comandă obișnuită.

**results\_ready\_emails** `string[]` *required*

Adresele care primesc fiecare câte un e-mail când toate rezultatele de laborator sunt finale, cu
litere mici. Gol când este dezactivat. Vezi
[E-mailuri pentru rezultate gata](https://docs.anivahealth.com/ro/concepts/results.md#e-mailuri-cand-rezultatele-sunt-gata).

**metadata** `object` *required*

Perechi cheie/valoare definite de partener, returnate exact așa cum au fost trimise. Întotdeauna prezent — `{}` când nu este setat.

**created\_at** `string` *required*

Marcajul temporal ISO 8601 al momentului în care a fost creată comanda de kit de testare la domiciliu.

**updated\_at** `string`

Timestamp ISO 8601 al ultimei actualizări. Poate fi `null`.

**profile** `object` *required*

Profilul pacientului asociat acestei comenzi de kit de testare la domiciliu.

**profil**

**id** `string`

Identificatorul unic al profilului (UUID).

**handle** `string`

Handle-ul profilului sau numele de utilizator. Poate fi `null`.

**first\_name** `string`

Prenume. Poate fi `null`.

**last\_name** `string`

Nume de familie. Poate fi `null`.

**email** `string`

Adresă de e-mail. Poate fi `null`.

**phone** `string`

Număr de telefon în format E.164. Poate fi `null`.

**sex** `integer`

Sex biologic conform ISO/IEC 5218. Poate fi `null`.

**date\_of\_birth** `string`

Data nașterii în format `YYYY-MM-DD`. Poate fi `null`.

**height** `number`

Înălțime în centimetri. Poate fi `null`.

**weight** `number`

Greutate în kilograme. Poate fi `null`.

**language** `string`

Limba preferată: unul dintre cele 32 de coduri din [Creează profil](https://docs.anivahealth.com/ro/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Indică dacă acest profil primește e-mailuri tranzacționale (programatice). Poate fi `null`.

**created\_at** `string`

Timestamp ISO 8601 al creării profilului.

**updated\_at** `string`

Timestamp ISO 8601 al ultimei actualizări a profilului. Poate fi `null`.

**panels** `HomeKitOrderPanel[]` *required*

Panelul atașat acestei comenzi de kit de testare la domiciliu — întotdeauna exact unul (un kit de testare la domiciliu corespunde 1:1 unui
produs fizic de tip kit), care poate fi schimbat prin [Actualizare](https://docs.anivahealth.com/ro/api/home-kit-orders/update-home-kit.md) cât timp este
`pending`. Consultă detaliile panelului (nume, biomarkeri) prin [Listare paneluri](https://docs.anivahealth.com/ro/api/panels/list-panels.md).

**Câmpuri pentru atașarea panelului**

**panel\_id** `string`

UUID-ul panelului — corelează cu [Listează panelurile](https://docs.anivahealth.com/ro/api/panels/list-panels.md).

**added\_at** `string`

Marcajul temporal ISO 8601 al momentului în care panelul a fost atașat prima dată la această comandă de kit de testare la domiciliu.

**individual\_biomarkers** `HomeKitOrderIndividualBiomarker[]` *required*

Biomarkeri individuali atașați acestei comenzi de kit de testare la domiciliu, în afara oricărui panel. Corelează fiecare
`biomarker_id` cu [Listare biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) folosind `home_kit=true` pentru datele de afișare.

**Câmpuri pentru biomarkeri individuali**

**biomarker\_id** `integer`

Identificatorul biomarkerului — corelează cu
[Listează biomarkerii](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) cu `home_kit=true`.

**added\_at** `string`

Marcajul temporal ISO 8601 al momentului în care biomarkerul a fost atașat prima dată la această comandă de kit de testare la domiciliu.

**shipments** `HomeKitOrderShipmentLink[]` *required*

Coletele asociate acestei comenzi de kit de testare la domiciliu, începând cu cea mai veche asociere — de obicei kitul către pacient
și proba înapoi la laborator. Gol până când centrul de expediere tipărește o etichetă. Citește
coletele complete cu [Listare expedieri](https://docs.anivahealth.com/ro/api/shipments/list-shipments.md) și `?home_kit_order_id=`.

**Câmpuri pentru asocierea expedierii**

**id** `string`

Referința expedierii — corelează cu [Obține expedierea](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md).

**added\_at** `string`

Marcajul temporal ISO 8601 al momentului în care expedierea a fost asociată acestei comenzi de kit de testare la domiciliu.

## Apeluri repetate

Aniva stochează răspunsul acestui endpoint timp de 60 de minute pentru fiecare cheie API. Un apel repetat în
acest interval primește răspunsul stocat cât timp comanda de kit de testare la domiciliu rămâne neschimbată. După o modificare, primești un răspuns
nou. Antetele `Cache-Status` și `Age` arată că răspunsul este
stocat și ce vechime are.

Pentru a afla imediat despre o modificare, abonează-te la evenimentele webhook `home_kit_order.created` și la evenimentul fiecărui status, de exemplu `home_kit_order.activated`.
Vezi [Citiri repetate](https://docs.anivahealth.com/ro/concepts/webhooks.md#citiri-repetate).

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Format de ID invalid — valoarea furnizată nu este un UUID valid. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune sau comanda de kit de testare la domiciliu este în afara domeniului tău de permisiuni. |
| `404` | Comanda de kit de testare la domiciliu nu a fost găsită. |
| `500` | Eroare internă de server. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "status": "dispatched",
  "delivery_address": {
    "name": "Maria Schmidt",
    "street": "Friedrichstraße",
    "house_number": "123",
    "postal_code": "10117",
    "city": "Berlin",
    "country_code": "DE",
    "phone": "+4930123456789",
    "email": "maria.schmidt@example.com"
  },
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": "2026-04-02T08:00:00Z",
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [
    {
      "biomarker_id": 42,
      "added_at": "2026-04-01T09:52:00Z"
    }
  ],
  "metadata": {},
  "replaces_home_kit_order_id": null,
  "replacement_reason": null,
  "results_ready_emails": [],
  "lab_code": "7642000123",
  "activated_at": null,
  "shipments": [
    { "id": "K2604021FQ7", "added_at": "2026-04-02T08:00:00Z" },
    { "id": "K260402P3XD", "added_at": "2026-04-02T08:00:00Z" }
  ]
}
```

```json 400 theme={null}
{
  "error": "id: Invalid home kit ID format"
}
```

```json 404 theme={null}
{
  "error": "Home kit order not found"
}
```


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