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

> Récupérer un lieu de test par son ID

Récupère un lieu. Il a la même structure qu'une entrée de
[Lister les lieux](https://docs.anivahealth.com/fr/api/locations/list-locations.md). L'`url` d'un événement
[webhook](https://docs.anivahealth.com/fr/concepts/webhooks.md) `location.*` pointe ici.

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

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant du lieu (UUID).

## Réponse

En cas de succès, l'API renvoie `200 OK` avec l'objet lieu.

**id** `string` *required*

Identifiant unique du lieu (UUID).

**name** `string` *required*

Nom d'affichage du lieu.

**company\_name** `string`

Nom de l'entreprise ou de la clinique. Peut être `null`.

**street** `string`

Nom de la rue, sans le numéro. Peut être `null`.

**house\_number** `string`

Numéro de rue. Peut être `null`.

**address\_line\_2** `string`

Complément d'adresse — chez, bâtiment ou étage. Peut être `null`.

**city** `string`

Ville. Peut être `null`.

**state** `string`

État ou province. Peut être `null` quand la ville n'a pas d'État associé (par ex. villes-États ou
imports non associés).

**state\_code** `string`

Code ISO 3166-2 de l'État sans le préfixe pays (par ex. `BW` pour le Bade-Wurtemberg). Peut être
`null`.

**postal\_code** `string`

Code postal ou code ZIP. Peut être `null`.

**country\_name** `string`

Nom complet du pays. Peut être `null`.

**country\_code** `string`

Code pays ISO 3166-1 alpha-2 (par ex. `DE`, `US`, `FI`). Peut être `null`.

**timezone** `string`

Identifiant de fuseau horaire IANA (par ex. `Europe/Berlin`). Peut être `null`.

**latitude** `number`

Latitude de l'adresse en degrés décimaux (WGS 84). Peut être `null`.

**longitude** `number`

Longitude de l'adresse en degrés décimaux (WGS 84). Peut être `null`.

**contact\_phone** `string`

Numéro de téléphone de contact du lieu. Peut être `null`.

**email** `string`

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

**website** `string`

URL du site web. Peut être `null`.

**google\_maps\_url** `string`

Lien Google Maps du lieu. Peut être `null`.

**image\_url** `string`

URL d'une photo du lieu. Peut être `null`.

**open\_hours** `object`

Horaires d'ouverture hebdomadaires. Chaque clé de jour de la semaine (`monday`–`sunday`) correspond
à un tableau de plages horaires d'ouverture et de fermeture. Un tableau vide signifie que le lieu
est fermé ce jour-là. L'objet entier est `null` quand les horaires ne sont pas disponibles pour le
lieu.

**plage horaire par jour**

**open** `string` *required*

Heure d'ouverture au format `HH:MM` (24 h).

**close** `string` *required*

Heure de fermeture au format `HH:MM` (24 h).

**default\_draw\_method** `string` *required*

Comment la prise de sang est effectuée lors d'un rendez-vous dans ce lieu, sauf si le rendez-vous
définit son propre `draw_method` : `capillary` (au bout du doigt ou dans le haut du bras, dans des
microtubes) ou `venous` (dans la veine, dans des tubes).

**draw\_methods** `string[]` *required*

Les méthodes de prise de sang pour lesquelles le lieu dispose de contenants, triées. Un
rendez-vous dans ce lieu ne peut définir que l'une d'entre elles comme `draw_method`.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | L'`id` n'est pas un UUID. |
| `401` | La clé API est manquante ou invalide. |
| `403` | Ta clé API n'a pas le scope requis. |
| `404` | Le lieu n'existe pas, est inactif ou est hors de ton périmètre d'accès. |
| `500` | Erreur interne du serveur. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations/b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "name": "Aniva Berlin Mitte",
  "company_name": "Aniva GmbH",
  "street": "Unter den Linden",
  "house_number": "42",
  "address_line_2": null,
  "city": "Berlin",
  "state": "Berlin",
  "state_code": "BE",
  "postal_code": "10117",
  "country_name": "Germany",
  "country_code": "DE",
  "timezone": "Europe/Berlin",
  "latitude": 52.517036,
  "longitude": 13.388859,
  "contact_phone": "+4930987654321",
  "email": "berlin-mitte@anivahealth.com",
  "website": "https://anivahealth.com",
  "google_maps_url": "https://maps.google.com/?q=Unter+den+Linden+42+Berlin",
  "image_url": "https://cdn.anivahealth.com/locations/berlin-mitte.jpg",
  "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": []
  },
  "default_draw_method": "venous",
  "draw_methods": ["venous"]
}
```


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