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

# Récupérer un rendez-vous

> Récupérer un rendez-vous de prise de sang par ID

Récupère un rendez-vous de prise de sang par son UUID, y compris le profil patient intégré. Utilise ce point de terminaison pour vérifier le statut d'un rendez-vous, confirmer les détails de planification ou récupérer les données du profil associé.

Nécessite le scope `appointments_view` ou `appointments_schedule`.

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant unique (UUID) du rendez-vous à récupérer.

## Réponse

En cas de succès, l'API renvoie `200 OK` avec le rendez-vous et son profil intégré.

**id** `string` *required*

Identifiant unique du rendez-vous (UUID).

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

UUID du profil auquel ce rendez-vous appartient.

**location\_id** `string`

UUID du lieu de test où la prise de sang a lieu.

**scheduled\_at** `string`

Date et heure prévues du rendez-vous en UTC (ISO 8601 avec suffixe `Z`, par ex.
`2026-05-15T10:30:00Z`). Peut être `null`.

**status** `string` *required*

Statut actuel du rendez-vous. Prend l'une des valeurs `pending`, `confirmed`, `blood_drawn` ou
`cancelled`. Le détail d'avancement des résultats de laboratoire s'obtient via
[Récupérer les résultats](https://docs.anivahealth.com/fr/api/appointments/get-results.md) ; la progression fine des envois via
chaque entrée du tableau `shipments` intégré (voir ci-dessous), puis
[Récupérer un envoi](https://docs.anivahealth.com/fr/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Motif en texte libre saisi lors de l'annulation du rendez-vous (par ex. absence, annulation tardive,
« Échec. À refaire »). `null` sauf si `status` vaut `cancelled`.

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

Adresses en minuscules qui reçoivent chacune un e-mail une fois tous les résultats de laboratoire
définitifs. Vide si désactivé. Voir [E-mails de résultats prêts](https://docs.anivahealth.com/fr/concepts/results.md#e-mails-de-resultats-prets).

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

Méthode de prise de sang : `capillary` (au bout du doigt ou sur le haut du bras, dans des microtubes) ou `venous` (dans la veine,
dans des tubes). C'est la méthode définie par le rendez-vous, sinon le `default_draw_method` de son
[lieu](https://docs.anivahealth.com/fr/concepts/locations.md). Après la prise de sang, c'est la méthode qui a été utilisée.

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

Horodatage ISO 8601 de création du rendez-vous.

**updated\_at** `string`

Horodatage ISO 8601 de la dernière mise à jour. Peut être `null`.

**profile** `object` *required*

Le profil patient associé à ce rendez-vous.

**Profil**

**id** `string`

Identifiant unique du profil (UUID).

**handle** `string`

Pseudonyme ou nom d'utilisateur du profil. Peut être `null`.

**first\_name** `string`

Prénom. Peut être `null`.

**last\_name** `string`

Nom de famille. Peut être `null`.

**email** `string`

Adresse e-mail. Peut être `null`.

**phone** `string`

Numéro de téléphone au format E.164. Peut être `null`.

**sex** `integer`

Sexe biologique selon la norme ISO/IEC 5218. Peut être `null`.

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

Date de naissance au format `YYYY-MM-DD`. Peut être `null`.

**height** `number`

Taille en centimètres. Peut être `null`.

**weight** `number`

Poids en kilogrammes. Peut être `null`.

**language** `string`

Langue préférée : l'un des 32 codes listés dans [Créer un profil](https://docs.anivahealth.com/fr/api/profiles/create-profile.md).

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

Indique si ce profil reçoit des e-mails transactionnels (automatisés). Peut être `null`.

**created\_at** `string`

Horodatage ISO 8601 de création du profil.

**updated\_at** `string`

Horodatage ISO 8601 de la dernière mise à jour du profil. Peut être `null`.

**panels** `AppointmentPanel[]` *required*

Panels actuellement associés à ce rendez-vous. Exclut les associations annulées. Consulte les détails d'un panel
(nom, biomarqueurs) via [Lister les panels](https://docs.anivahealth.com/fr/api/panels/list-panels.md).

**Champs de rattachement de panel**

**panel\_id** `string`

UUID du panel — à croiser avec [Lister les panels](https://docs.anivahealth.com/fr/api/panels/list-panels.md).

**added\_at** `string`

Horodatage ISO 8601 auquel le panel a été rattaché pour la première fois à ce rendez-vous.

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

Biomarqueurs à la carte rattachés à ce rendez-vous en dehors de tout panel (voir [Ajouter des biomarqueurs
personnalisés](https://docs.anivahealth.com/fr/api/appointments/add-individual-biomarkers.md)). Croise chaque `biomarker_id`
avec [Lister les biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md) pour obtenir les données d'affichage.

**Champs de biomarqueur individuel**

**biomarker\_id** `integer`

Identifiant du biomarqueur — à croiser avec
[Lister les biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

Horodatage ISO 8601 auquel le biomarqueur a été rattaché pour la première fois à ce rendez-vous.

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

Expéditions liées à ce rendez-vous, du lien le plus ancien au plus récent. Tableau vide lorsqu'aucune expédition n'est
liée. Recoupe chaque `id` avec [Obtenir une expédition](https://docs.anivahealth.com/fr/api/shipments/get-shipment.md) pour obtenir les
données complètes de l'expédition (statut, numéro de suivi, mises à jour de statut, etc.).

**Champs de lien d'expédition**

**id** `string`

Identifiant de référence de l'expédition — à croiser avec
[Obtenir une expédition](https://docs.anivahealth.com/fr/api/shipments/get-shipment.md).

**added\_at** `string`

Horodatage ISO 8601 auquel l'expédition a été liée pour la première fois à ce rendez-vous.

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

Codes laboratoire (codes-barres des tubes) enregistrés pour ce rendez-vous, dans l'ordre de scan. Vide jusqu'à
la confirmation de la prise de sang. Une prise de sang veineuse porte un seul code imprimé sur chaque tube ; une prise de sang capillaire porte un
code par microtube. Les résultats et documents dans [Obtenir les résultats](https://docs.anivahealth.com/fr/api/appointments/get-results.md) référencent
ces codes via `lab_code`.

## Appels répétés

Aniva stocke la réponse de ce point de terminaison pendant 15 minutes pour chaque clé API. Un appel répété pendant
ce délai reçoit la réponse stockée tant que le rendez-vous n'a pas changé. Après une modification, tu obtiens une nouvelle
réponse. Les en-têtes `Cache-Status` et `Age` indiquent que la réponse est
stockée et depuis combien de temps.

Pour être informé d'un changement immédiatement, abonne-toi aux événements webhook `appointment.created`, `appointment.rescheduled` et à l'événement de chaque statut, par exemple `appointment.confirmed`.
Voir [Lectures répétées](https://docs.anivahealth.com/fr/concepts/webhooks.md#lectures-repetees).

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Format d'identifiant invalide — la valeur fournie n'est pas un UUID valide. |
| `403` | Accès refusé — ta clé API n'a pas accès à cette opération. |
| `404` | Rendez-vous introuvable. |
| `500` | Erreur interne du serveur. |

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