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

# Annulla appuntamento

> Annulla un appuntamento per il prelievo di sangue

Annulla un appuntamento impostando il suo stato su `cancelled`. Possono essere annullati solo gli appuntamenti per cui il prelievo di sangue non è ancora stato confermato.

Annullare un appuntamento già `cancelled` restituisce `200` con quell'appuntamento e non scrive nulla — non viene registrato un secondo annullamento. La risposta include `Idempotent-Replayed: true` così puoi distinguere una ripetizione dalla chiamata che ha eseguito l'operazione. Una ripetizione con un `cancellation_reason` **diverso** restituisce invece `409`: il motivo registrato non viene mai sovrascritto. Vedi [Idempotenza](https://docs.anivahealth.com/it/concepts/idempotency.md).

> [!WARNING]
>
> Gli appuntamenti non possono essere annullati dopo la conferma del prelievo di sangue — l'operazione restituisce `409
>     Conflict`.

Richiede lo scope `appointments_schedule` o `appointments_manage`.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore univoco (UUID) dell'appuntamento da annullare.

### Parametri del body

Il body è facoltativo — non inviare alcun body per annullare senza registrare un motivo.

**cancellation\_reason** `string`

Motivo dell'annullamento in testo libero, fino a 500 caratteri (es. `Patient no-show`). Salvato
sull'appuntamento e restituito come `cancellation_reason` in questa lettura e in quelle successive.

## Risposta

In caso di successo, l'API restituisce `200 OK` con l'appuntamento annullato 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 dell'appuntamento. Sarà `cancelled` dopo un annullamento riuscito.

**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 collegati a questo appuntamento prima dell'annullamento. Consulta i dettagli dei pannelli (nome,
biomarcatori) tramite [Elenca 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 prima dell'annullamento. Ogni `id` rimanda
a [Ottieni spedizione](https://docs.anivahealth.com/it/api/shipments/get-shipment.md).

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

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Formato ID non valido, oppure body malformato / `cancellation_reason` più lungo di 500 caratteri. |
| `403` | Accesso negato — la tua chiave API non ha accesso a questa operazione o l'appuntamento è fuori dal tuo contesto di accesso. |
| `404` | Appuntamento non trovato. |
| `409` | Il prelievo di sangue è già stato confermato oppure l'appuntamento è già stato annullato con un motivo diverso. |
| `500` | Errore interno del server. |

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

```bash cURL (with a reason) theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "cancellation_reason": "Patient no-show"
  }'
```

```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": "cancelled",
  "cancellation_reason": "Patient no-show",
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": "2026-04-10T12: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": [],
  "shipments": [],
  "lab_codes": []
}
```

```json 409 theme={null}
{
  "error": "This appointment is already cancelled with a different cancellation_reason. Re-send the recorded reason, or omit it, to read the cancelled appointment back."
}
```

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


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