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

# Ottieni ordine di kit domiciliare

> Recupera un kit per test domiciliare fai da te tramite ID

Recupera un singolo ordine di kit domiciliare tramite il suo UUID, incluso il profilo del paziente incorporato. Usa questo endpoint per verificare lo stato dell'ordine, controllare l'indirizzo di consegna o ispezionare i pannelli e i biomarcatori associati.

Richiede lo scope `home_kit_orders_view` o `home_kit_orders_manage`.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore univoco (UUID) dell'ordine di kit domiciliare da recuperare.

## Risposta

In caso di successo, l'API restituisce `200 OK` con l'ordine di kit domiciliare e il relativo profilo incorporato.

**id** `string` *required*

Identificatore univoco dell'ordine di kit domiciliare (UUID).

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

UUID del profilo a cui appartiene questo ordine di kit domiciliare.

**status** `string` *required*

Stato attuale dell'ordine di kit domiciliare. Uno tra `pending`, `dispatched`, `activated` o `cancelled`.
Il dettaglio sul completamento dei risultati di laboratorio deriva da [Ottieni risultati](https://docs.anivahealth.com/it/api/home-kit-orders/get-results.md).

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

L'indirizzo a cui spedire il kit — in uno di due formati: `{ location_id }` che fa riferimento a una sede di test nota, oppure i campi dell'indirizzo inline (`name`, `street`, `city`, `postal_code`, `country_code`; `company_name` / `house_number` / `address_line_2` / `state` / `phone` / `email` opzionali — lo stesso vocabolario dell'API delle sedi). Fornisci esattamente uno dei due — un riferimento a una sede o un indirizzo inline, non entrambi.

**indirizzo di consegna**

> [tab] Riferimento sede
>
> **location\_id** `string` *required*
>
> UUID della sede di test a cui viene spedito il kit.

> [tab] Indirizzo inline
>
> **name** `string` *required*
>
> Nome del destinatario, dell'azienda o della sede.
>
> **company\_name** `string`
>
> Azienda che riceve il pacco per conto del destinatario — un destinatario `c/o` o un reparto.
>
> **street** `string` *required*
>
> Nome della via, senza il numero civico (ad es. `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Numero civico (ad es. `118` o `12a`).
>
> **address\_line\_2** `string`
>
> Edificio, ingresso o piano.
>
> **city** `string` *required*
>
> **state** `string`
>
> Stato o provincia. Opzionale.
>
> **postal\_code** `string` *required*
>
> **country\_code** `string` *required*
>
> Codice ISO 3166-1 alpha-2 (due lettere, ad es. `DE`).
>
> **phone** `string`
>
> **email** `string`

**lab\_code** `string`

Codice campione di laboratorio con cui vengono refertati i risultati — stampato sul kit fisico e
letto dal paziente sulla scatola come codice di attivazione. `null` finché il kit non viene imballato.
Di sola lettura.

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

Timestamp di raccolta segnalato tramite [Attiva](https://docs.anivahealth.com/it/api/home-kit-orders/activate-home-kit.md) — quando il
paziente ha raccolto il campione. `null` finché il kit non viene attivato.

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

L'ordine di kit domiciliare sostituito da questo, quando si tratta di un kit sostitutivo. `null` su un ordine normale. Consulta
[Crea ordine di kit domiciliare](https://docs.anivahealth.com/it/api/home-kit-orders/create-home-kit.md).

**replacement\_reason** `string`

Motivo per cui è stata inviata la sostituzione. `null` su un ordine normale.

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

Indirizzi che ricevono ciascuno un'email quando tutti i risultati di laboratorio sono definitivi, in minuscolo. Vuoto se disattivato. Vedi
[Email di risultati pronti](https://docs.anivahealth.com/it/concepts/results.md#email-di-risultati-pronti).

**metadata** `object` *required*

Coppie chiave/valore definite dal partner, restituite esattamente come inviate. Sempre presente — `{}` se non impostato.

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

Timestamp ISO 8601 della creazione dell'ordine di kit domiciliare.

**updated\_at** `string`

Timestamp ISO 8601 dell'ultimo aggiornamento. Può essere `null`.

**profile** `object` *required*

Il profilo del paziente associato a questo ordine di kit domiciliare.

**profilo**

**id** `string`

Identificatore univoco del profilo (UUID).

**handle** `string`

Handle o nome utente del profilo. Può essere `null`.

**first\_name** `string`

Nome. Può essere `null`.

**last\_name** `string`

Cognome. Può essere `null`.

**email** `string`

Indirizzo email. Può essere `null`.

**phone** `string`

Numero di telefono in formato E.164. Può essere `null`.

**sex** `integer`

Sesso biologico secondo ISO/IEC 5218. Può essere `null`.

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

Data di nascita in formato `YYYY-MM-DD`. Può essere `null`.

**height** `number`

Altezza in centimetri. Può essere `null`.

**weight** `number`

Peso in chilogrammi. Può essere `null`.

**language** `string`

Lingua preferita: uno dei 32 codici in [Crea profilo](https://docs.anivahealth.com/it/api/profiles/create-profile.md).

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

Indica se questo profilo riceve email transazionali (programmatiche). Può essere `null`.

**created\_at** `string`

Timestamp ISO 8601 della creazione del profilo.

**updated\_at** `string`

Timestamp ISO 8601 dell'ultimo aggiornamento del profilo. Può essere `null`.

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

Il pannello associato a questo ordine di kit domiciliare — sempre esattamente uno (un kit domiciliare corrisponde 1:1 a un
prodotto kit fisico), sostituibile tramite [Aggiorna](https://docs.anivahealth.com/it/api/home-kit-orders/update-home-kit.md) finché
è `pending`. Consulta i dettagli del pannello (nome, biomarcatori) tramite [Elenca pannelli](https://docs.anivahealth.com/it/api/panels/list-panels.md).

**Campi del pannello associato**

**panel\_id** `string`

UUID del pannello — confrontalo con [Elenca pannelli](https://docs.anivahealth.com/it/api/panels/list-panels.md).

**added\_at** `string`

Timestamp ISO 8601 in cui il pannello è stato associato per la prima volta a questo ordine di kit domiciliare.

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

Biomarcatori singoli associati a questo ordine di kit domiciliare al di fuori di qualsiasi pannello. Confronta ogni
`biomarker_id` con [Elenca biomarcatori](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md) con `home_kit=true` per i dati di visualizzazione.

**Campi del biomarcatore singolo**

**biomarker\_id** `integer`

Identificatore del biomarcatore — confrontalo con
[Elenca biomarcatori](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md) con `home_kit=true`.

**added\_at** `string`

Timestamp ISO 8601 in cui il biomarcatore è stato associato per la prima volta a questo ordine di kit domiciliare.

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

Pacchi collegati a questo ordine di kit domiciliare, dal collegamento più vecchio in poi — di solito il kit verso il paziente
e il campione di ritorno al laboratorio. Vuoto finché la logistica non stampa un'etichetta. Leggi i
pacchi completi con [Elenca spedizioni](https://docs.anivahealth.com/it/api/shipments/list-shipments.md) e `?home_kit_order_id=`.

**Campi del collegamento alla spedizione**

**id** `string`

Riferimento della spedizione — confrontalo con [Ottieni spedizione](https://docs.anivahealth.com/it/api/shipments/get-shipment.md).

**added\_at** `string`

Timestamp ISO 8601 in cui la spedizione è stata collegata a questo ordine di kit domiciliare.

## Chiamate ripetute

Aniva memorizza la risposta di questo endpoint per 60 minuti per ogni chiave API. Una chiamata ripetuta entro
questo intervallo riceve la risposta memorizzata finché l'ordine di kit domiciliare non cambia. Dopo una modifica, ricevi una risposta
aggiornata. Gli header `Cache-Status` e `Age` mostrano che la risposta è
memorizzata e quanto è vecchia.

Per sapere subito di una modifica, iscriviti agli eventi webhook `home_kit_order.created` e all'evento di ogni stato, ad esempio `home_kit_order.activated`.
Vedi [Letture ripetute](https://docs.anivahealth.com/it/concepts/webhooks.md#letture-ripetute).

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Formato ID non valido — il valore fornito non è un UUID valido. |
| `403` | Accesso negato — la tua chiave API non ha accesso a questa operazione oppure l'ordine di kit domiciliare è fuori dal tuo ambito di autorizzazioni. |
| `404` | Ordine di kit domiciliare non trovato. |
| `500` | Errore interno del 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.