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

# Avvio rapido

> Fai la tua prima chiamata all'Aniva Partner API in pochi minuti: trova una sede per gli esami, crea un profilo e prenota un prelievo di sangue.

Questa guida ti accompagna nel flusso di lavoro principale: trovare una sede di analisi, creare un profilo paziente, prenotare un appuntamento e confermare un prelievo di sangue.

## Prerequisiti

Ti serve una chiave API partner rilasciata da Aniva.

> [!NOTE]
>
> Se non hai ancora una chiave API, contatta Aniva per ottenerne una per il tuo account partner.

## Passaggi

**1. Elenca le sedi disponibili**

Recupera l'elenco delle sedi di analisi per trovare un `location_id` per l'appuntamento che prenoterai.

```bash theme={null}
curl https://anivahealth.com/api/v1/locations \
  -H "x-api-key: YOUR_API_KEY"
```

**Risposta di esempio**

```json theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": null,
    "image_url": null,
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

Annota l'`id` della sede che vuoi usare. Ti servirà nel passaggio 3.

**2. Crea un profilo**

Crea il profilo di un paziente inviando i suoi dati anagrafici. Il campo `profile_group` collega il profilo al tuo account partner — accetta l'UUID immutabile del gruppo oppure il suo slug leggibile.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/profiles \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Rivera",
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "profile_group": "your-profile-group"
  }'
```

**Campi del corpo della richiesta**

| Campo | Tipo | Obbligatorio | Descrizione |
| - | - | - | - |
| `first_name` | string | Sì | Nome del paziente |
| `last_name` | string | Sì | Cognome del paziente |
| `sex` | integer | Sì\*\* | `1` = maschio, `2` = femmina (ISO/IEC 5218) |
| `date_of_birth` | string | Sì\*\* | Data di nascita in formato `YYYY-MM-DD`. Deve essere nel passato, non prima del 1900 e corrispondere a un'età tra 16 e 100 anni. |
| `profile_group` | string | Sì\* | UUID o slug del tuo gruppo di profili partner. L'UUID è il riferimento stabile; è accettato anche lo slug. |
| `profile_group_slug` | string | No | **Deprecato.** Alias slug per `profile_group`. È obbligatorio `profile_group` oppure `profile_group_slug`. |
| `email` | string | No | Email del paziente. Generata automaticamente se omessa. |
| `language` | string | No | `en`, `de` o `fi`. Il valore predefinito è `en`. |
| `phone` | string | No | Numero di telefono in formato E.164, ad esempio `+4915123456789`. |
| `height` | number | No | Altezza in centimetri. |
| `weight` | number | No | Peso in chilogrammi. |
| `transactional_emails_enabled` | boolean | No | Sovrascrive l'impostazione predefinita del gruppo di profili per le email operative. |
| `marketing_emails_enabled` | boolean | No | Sovrascrive l'impostazione predefinita del gruppo di profili per le email di marketing. |

\*\* Facoltativo quando il tuo gruppo di profili consente al paziente di inserire entrambi i dati nella pagina di attivazione del kit. Vedi
[Profili](https://docs.anivahealth.com/it/concepts/profiles.md#consenti-al-paziente-di-inserire-data-di-nascita-e-sesso).

**Risposta di esempio (201 Created)**

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "handle": null,
  "first_name": "Jordan",
  "last_name": "Rivera",
  "email": "jordan.rivera@example.com",
  "phone": null,
  "sex": 1,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "en",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null
}
```

Annota l'`id` dalla risposta. Lo userai come `profile_id` nel passaggio successivo.

**3. Prenota un appuntamento**

Crea un appuntamento usando il `profile_id` del passaggio 2 e il `location_id` del passaggio 1. Imposta `scheduled_at` sull'orario di inizio di uno slot restituito da [Ottieni disponibilità](https://docs.anivahealth.com/it/api/locations/get-availability.md) per quella sede. L'API rifiuta qualsiasi orario che non rientra nella griglia degli slot.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "scheduled_at": "2026-04-10T09:00:00Z"
  }'
```

**Risposta di esempio (201 Created)**

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "scheduled_at": "2026-04-10T09:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T10:05:00Z",
  "updated_at": null,
  "profile": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "handle": null,
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": null,
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "en",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T10:00:00Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Annota l'`id` dell'appuntamento. Lo userai per confermare il prelievo di sangue.

**4. Conferma il prelievo di sangue**

Completato il prelievo di sangue, invia il codice di laboratorio (codice a barre della provetta) per confermare il prelievo e avviare la pipeline degli ordini di laboratorio. Se le provette di un prelievo riportano più codici, invia invece `lab_codes` — vedi [Conferma prelievo di sangue](https://docs.anivahealth.com/it/api/appointments/confirm-blood-draw.md).

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments/c3d4e5f6-a7b8-9012-cdef-123456789012/confirm \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lab_code": "7642001234"
  }'
```

**Risposta di esempio (200 OK)**

```json theme={null}
{
  "success": true
}
```

Dopo la conferma, viene avviata la pipeline degli ordini di laboratorio. Puoi recuperare l'appuntamento per verificare che il suo stato sia passato a `"blood_drawn"`.

## Prossimi passaggi

* [Aggiungi pannelli a un appuntamento](https://docs.anivahealth.com/it/api/appointments/add-panels.md) per specificare quali esami di laboratorio eseguire.
* [Aggiorna un appuntamento](https://docs.anivahealth.com/it/api/appointments/update-appointment.md) per riprogrammarlo o cambiare sede prima del prelievo di sangue.
* [Annulla un appuntamento](https://docs.anivahealth.com/it/api/appointments/cancel-appointment.md) se non è più necessario.
* [Ottieni i risultati di laboratorio](https://docs.anivahealth.com/it/api/appointments/get-results.md) per recuperare i risultati clinici e genetici dopo l'elaborazione.
* [Scarica documenti](https://docs.anivahealth.com/it/api/documents/download-document.md) per recuperare i PDF dei referti di laboratorio.
* [Recupera un profilo](https://docs.anivahealth.com/it/api/profiles/get-profile.md) per verificare o mostrare i dati del paziente.
* Consulta il [riferimento API](https://docs.anivahealth.com/it/api/profiles/create-profile.md) completo per tutti gli endpoint e i parametri disponibili.


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