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

# Locatie ophalen

> Eén testlocatie ophalen op ID

Haal één locatie op. Deze heeft dezelfde structuur als een item uit
[Locaties ophalen](https://docs.anivahealth.com/nl/api/locations/list-locations.md). De `url` van een `location.*`
[webhook](https://docs.anivahealth.com/nl/concepts/webhooks.md)-event verwijst hiernaar.

Vereist de scope `locations_view` of `appointments_schedule`.

## Verzoek

### Padparameters

**id** `string` *required*

Locatie-ID (UUID).

## Respons

Bij succes geeft de API `200 OK` terug met het locatieobject.

**id** `string` *required*

Unieke locatie-identifier (UUID).

**name** `string` *required*

Weergavenaam van de locatie.

**company\_name** `string`

Naam van het bedrijf of de kliniek. Kan `null` zijn.

**street** `string`

Straatnaam, zonder huisnummer. Kan `null` zijn.

**house\_number** `string`

Huisnummer. Kan `null` zijn.

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

Extra adresregel — p/a, gebouw of verdieping. Kan `null` zijn.

**city** `string`

Stad. Kan `null` zijn.

**state** `string`

Deelstaat of provincie. Kan `null` zijn als de stad geen gekoppelde deelstaat heeft (bijv. stadstaten
of niet-gekoppelde imports).

**state\_code** `string`

De ISO 3166-2-code van de deelstaat zonder het landvoorvoegsel (bijv. `BW` voor Baden-Württemberg). Kan
`null` zijn.

**postal\_code** `string`

Postcode. Kan `null` zijn.

**country\_name** `string`

Volledige landsnaam. Kan `null` zijn.

**country\_code** `string`

ISO 3166-1 alpha-2-landcode (bijv. `DE`, `US`, `FI`). Kan `null` zijn.

**timezone** `string`

IANA-tijdzone-identifier (bijv. `Europe/Berlin`). Kan `null` zijn.

**latitude** `number`

Breedtegraad van het adres in decimale graden (WGS 84). Kan `null` zijn.

**longitude** `number`

Lengtegraad van het adres in decimale graden (WGS 84). Kan `null` zijn.

**contact\_phone** `string`

Contacttelefoonnummer van de locatie. Kan `null` zijn.

**email** `string`

E-mailadres voor contact. Kan `null` zijn.

**website** `string`

Website-URL. Kan `null` zijn.

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

Google Maps-link voor de locatie. Kan `null` zijn.

**image\_url** `string`

URL van een foto van de locatie. Kan `null` zijn.

**open\_hours** `object`

Wekelijkse openingstijden. Elke sleutel voor een weekdag (`monday`–`sunday`) verwijst naar een array van
tijdvakken met openings- en sluitingstijd. Een lege array betekent dat de locatie die dag gesloten is. Het hele object is `null`
als er geen openingstijden beschikbaar zijn voor de locatie.

**tijdvak per dag**

**open** `string` *required*

Openingstijd in `HH:MM`-notatie (24 uur).

**close** `string` *required*

Sluitingstijd in `HH:MM`-notatie (24 uur).

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

Hoe het bloed hier tijdens een afspraak wordt afgenomen, tenzij de afspraak een eigen `draw_method` instelt:
`capillary` (vingertop of bovenarm, in microtainers) of `venous` (uit de ader, in buisjes).

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

De afnamemethoden waarvoor de locatie afnamemateriaal op voorraad heeft, gesorteerd. Een afspraak hier kan alleen een
van deze methoden instellen als `draw_method`.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | De `id` is geen UUID. |
| `401` | De API-sleutel ontbreekt of is ongeldig. |
| `403` | Je API-sleutel heeft niet de vereiste scope. |
| `404` | De locatie bestaat niet, is inactief of valt buiten je toegang. |
| `500` | Interne serverfout. |

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