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

# Planifier un rendez-vous

> Guide étape par étape : trouver un lieu de test, vérifier les disponibilités et réserver un rendez-vous de prise de sang avec l'API Aniva.

Utilise ce guide pour trouver un lieu de prélèvement, créer un rendez-vous pour un profil patient et associer les panels d'analyse à effectuer. Termine ces étapes avant l'arrivée du patient pour sa prise de sang.

**1. Parcourir les lieux disponibles**

Récupère la liste des lieux de prélèvement disponibles sur ton compte en envoyant une requête `GET` à `/api/v1/locations`.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/locations', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
  },
});

const locations = await response.json();
```

La réponse est un tableau d'objets lieu :

```json theme={null}
[
  {
    "id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Friedrichstraße",
    "house_number": "112",
    "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": "17:00" }],
      "tuesday": [{ "open": "08:00", "close": "17:00" }],
      "wednesday": [{ "open": "08:00", "close": "17:00" }],
      "thursday": [{ "open": "08:00", "close": "17:00" }],
      "friday": [{ "open": "08:00", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

> [!TIP]
>
> Utilise le champ `timezone` de l'objet lieu lorsque tu construis ton horodatage `scheduled_at`. Convertir l'heure du rendez-vous dans le fuseau horaire local du lieu t'évite de planifier en dehors des horaires d'ouverture.

> [!WARNING]
>
> Ne déduis pas les créneaux réservables uniquement à partir de `open_hours`. Appelle [Obtenir les disponibilités](https://docs.anivahealth.com/fr/api/locations/get-availability.md) et réserve un début de créneau qu'il renvoie — cette grille tient aussi compte des réservations existantes, des exceptions par date et du délai minimal.

**2. Créer le rendez-vous**

Envoie une requête `POST` à `/api/v1/appointments` avec l'ID du profil, l'ID du lieu et l'heure de rendez-vous souhaitée. L'heure doit correspondre à un début de créneau renvoyé par [Obtenir les disponibilités](https://docs.anivahealth.com/fr/api/locations/get-availability.md).

> [!NOTE]
>
> `scheduled_at` doit être une date et heure future au format ISO 8601, par exemple `2026-05-12T07:30:00Z`. Les horodatages dans le passé sont rejetés avec une erreur `400`, tout comme les horaires compris dans le [délai minimal de 12 heures](https://docs.anivahealth.com/fr/api/appointments/create-appointment.md#delai-minimum) pour les lieux gérés par Aniva.

> [!TIP]
>
> Répéter cette requête est sans risque. Un profil ne peut avoir qu'un seul rendez-vous par lieu et par horaire, donc une création renvoyée ou soumise en double retourne `409` avec l'`appointment_id` existant au lieu de réserver deux fois pour le patient.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "scheduled_at": "2026-05-12T07:30:00Z"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/appointments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    profile_id: 'a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
    location_id: 'b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421',
    scheduled_at: '2026-05-12T07:30:00Z',
  }),
});

const appointment = await response.json();
```

Une requête réussie renvoie `201 Created` avec l'objet rendez-vous :

```json theme={null}
{
  "id": "c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12",
  "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
  "scheduled_at": "2026-05-12T07:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T11:02:47Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "handle": null,
    "first_name": "Emma",
    "last_name": "Müller",
    "email": "emma.muller@example.com",
    "phone": null,
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "de",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T09:14:22Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Conserve l'`id` du rendez-vous — tu en auras besoin pour ajouter des panels et confirmer la prise de sang.

**3. Ajouter des panels d'analyse**

Associe les panels d'analyse à effectuer sur l'échantillon de sang en envoyant une requête `POST` à `/api/v1/appointments/{id}/panels`.

Les ID de panel sont des UUID. Appelle [Lister les panels](https://docs.anivahealth.com/fr/api/panels/list-panels.md) pour obtenir les panels que ta clé API peut commander.

> [!WARNING]
>
> Il est impossible d'ajouter des panels une fois la prise de sang confirmée. Ajoute tous les panels requis avant la confirmation — consulte [Confirmer la prise de sang](https://docs.anivahealth.com/fr/guides/confirm-blood-draw.md) pour en savoir plus.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "panel_ids": [
      "d1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27",
      "e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38"
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      panel_ids: [
        'd1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27',
        'e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38',
      ],
    }),
  }
);

const result = await response.json();
```

Une requête réussie renvoie `200 OK` pour confirmer que les panels ont été ajoutés :

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

## Replanifier ou annuler

Après avoir créé un rendez-vous, tu peux encore le modifier avant que la prise de sang ne soit confirmée :

* **Replanifier ou changer de lieu** — Envoie une requête `PATCH` à `/api/v1/appointments/{id}` avec les champs à mettre à jour. Consulte [Mettre à jour un rendez-vous](https://docs.anivahealth.com/fr/api/appointments/update-appointment.md).
* **Annuler** — Envoie une requête `DELETE` à `/api/v1/appointments/{id}`. Consulte [Annuler un rendez-vous](https://docs.anivahealth.com/fr/api/appointments/cancel-appointment.md).

> [!NOTE]
>
> Les deux opérations ne sont disponibles qu'avant la prise de sang — c'est-à-dire tant que le
> rendez-vous a le statut `pending` ou `confirmed`. Une fois que le rendez-vous passe au statut
> `blood_drawn`, aucune modification n'est plus possible.

## Gestion des erreurs

| Statut | Cause | Résolution |
| - | - | - |
| `400 Bad Request` | Un champ obligatoire est manquant, `scheduled_at` est dans le passé, ne figure pas sur la grille des créneaux ou se situe dans le délai minimal de 12 heures, ou `panel_ids` est vide. | Consulte le corps de l'erreur pour voir le message de validation et corrige la requête. Pour le délai minimal, choisis un créneau plus tardif dans [Obtenir les disponibilités](https://docs.anivahealth.com/fr/api/locations/get-availability.md). |
| `403 Forbidden` | Ta clé API n'a pas accès à cette opération. | Contacte Aniva pour confirmer les autorisations de ta clé API. |
| `404 Not Found` | `profile_id` ou `location_id` n'existe pas, ou l'ID du rendez-vous est invalide lors de l'ajout de panels. | Vérifie que les ID sont corrects et appartiennent à ton compte. |
| `409 Conflict` | Tu as tenté d'ajouter des panels à un rendez-vous déjà en statut `blood_drawn` ou `cancelled`, ou de le modifier. | Aucune modification n'est plus possible après confirmation. |
| `409 Conflict` | Ce profil a déjà un rendez-vous dans ce lieu à cette heure, ou le créneau est complet. | En cas de doublon, la réponse contient l'`appointment_id` existant — utilise ce rendez-vous au lieu de réessayer. Sinon, choisis un autre créneau. |


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