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

> Recupera un appuntamento per il prelievo di sangue tramite ID

Recupera un singolo appuntamento per un prelievo di sangue tramite il suo UUID, incluso il profilo paziente incorporato. Usa questo endpoint per verificare lo stato dell'appuntamento, confermare i dettagli della prenotazione o recuperare i dati del profilo associato.

Richiede lo scope `appointments_view` o `appointments_schedule`.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore univoco (UUID) dell'appuntamento da recuperare.

## Risposta

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

**id** `string` *required*

Identificatore univoco dell'appuntamento (UUID).

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

UUID del profilo a cui appartiene questo appuntamento.

**location\_id** `string`

UUID della sede del test in cui avviene il prelievo di sangue.

**scheduled\_at** `string`

Data e ora programmate dell'appuntamento come istante UTC (ISO 8601 con suffisso `Z`, es.
`2026-05-15T10:30:00Z`). Può essere `null`.

**status** `string` *required*

Stato attuale dell'appuntamento. Uno tra `pending`, `confirmed`, `blood_drawn` o `cancelled`.
Il dettaglio di completamento dei risultati di laboratorio si ricava da [Ottieni risultati](https://docs.anivahealth.com/it/api/appointments/get-results.md);
l'avanzamento più dettagliato delle spedizioni da ciascuna voce nell'array inline `shipments` (vedi sotto),
da consultare su [Ottieni spedizione](https://docs.anivahealth.com/it/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Motivo in testo libero registrato al momento dell'annullamento dell'appuntamento (es. mancata
presentazione, annullamento tardivo, 'Non riuscito. Ripetizione necessaria'). `null` a meno che `status` non sia `cancelled`.

**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).

**draw\_method** `string` *required*

Come viene effettuato il prelievo di sangue: `capillary` (dal polpastrello o dalla parte superiore del braccio, in microprovette) o `venous` (dalla vena,
in provette). È il metodo impostato dall'appuntamento, altrimenti il `default_draw_method` della sua
[sede](https://docs.anivahealth.com/it/concepts/locations.md). Dopo il prelievo di sangue, è il metodo utilizzato.

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

Timestamp ISO 8601 della creazione dell'appuntamento.

**updated\_at** `string`

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

**profile** `object` *required*

Il profilo del paziente associato a questo appuntamento.

**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** `AppointmentPanel[]` *required*

Pannelli attualmente associati a questo appuntamento. Esclude le associazioni annullate. Consulta i dettagli del pannello
(nome, biomarcatori) tramite [Elenco pannelli](https://docs.anivahealth.com/it/api/panels/list-panels.md).

**Campi del pannello collegato**

**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 del momento in cui il pannello è stato collegato per la prima volta a questo appuntamento.

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

Biomarcatori singoli collegati a questo appuntamento al di fuori dei pannelli (vedi [Aggiungi biomarcatori
personalizzati](https://docs.anivahealth.com/it/api/appointments/add-individual-biomarkers.md)). Confronta ogni `biomarker_id`
con [Elenca biomarcatori](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md) 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).

**added\_at** `string`

Timestamp ISO 8601 del momento in cui il biomarcatore è stato collegato per la prima volta a questo appuntamento.

**shipments** `AppointmentShipmentLink[]` *required*

Spedizioni collegate a questo appuntamento, a partire dal collegamento più vecchio. Array vuoto quando nessuna spedizione è
collegata. Confronta ogni `id` con [Ottieni spedizione](https://docs.anivahealth.com/it/api/shipments/get-shipment.md) per il
payload completo della spedizione (stato, numero di tracciamento, aggiornamenti di stato, ecc.).

**Campi del collegamento della spedizione**

**id** `string`

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

**added\_at** `string`

Timestamp ISO 8601 del momento in cui la spedizione è stata collegata per la prima volta a questo appuntamento.

**lab\_codes** `string[]` *required*

Codici di laboratorio (codici a barre delle provette) registrati per questo appuntamento, in ordine di scansione. Vuoto finché il prelievo di sangue
non viene confermato. Un prelievo venoso ha un unico codice stampato su ogni provetta; un prelievo capillare ha un
codice per ogni microprovetta. Risultati e documenti in [Ottieni risultati](https://docs.anivahealth.com/it/api/appointments/get-results.md) fanno riferimento
a questi codici tramite `lab_code`.

## Chiamate ripetute

Aniva memorizza la risposta di questo endpoint per 15 minuti per ciascuna chiave API. Una chiamata ripetuta entro
questo intervallo riceve la risposta memorizzata finché l'appuntamento non cambia. Dopo una modifica, ricevi una risposta
aggiornata. Gli header `Cache-Status` e `Age` indicano che la risposta è
memorizzata e da quanto tempo lo è.

Per conoscere subito una modifica, iscriviti agli eventi webhook `appointment.created`, `appointment.rescheduled` e all'evento di ciascuno stato, ad esempio `appointment.confirmed`.
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. |
| `404` | Appuntamento non trovato. |
| `500` | Errore interno del server. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "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"
    }
  ],
  "shipments": [
    {
      "id": "P2611194821",
      "added_at": "2026-04-15T07:00:00Z"
    }
  ],
  "lab_codes": []
}
```

```json 400 theme={null}
{
  "error": "Invalid appointment ID format"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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