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

# Locaties

> Hoe testlocaties werken in de Aniva API: apotheken en praktijken voor bloedafname, openingstijden, beschikbaarheid en consumentenprijzen.

Een locatie is een fysiek testcentrum waar bloedafnames worden uitgevoerd door zorgprofessionals. Je gebruikt de `id` van een locatie om `practitioner`-afspraken in te plannen.

> [!NOTE]
>
> Je API-sleutel geeft alleen locaties binnen jouw partnertoegangscontext terug. Gebruik `GET
>     /api/v1/locations` om alle locaties op te vragen die voor jou beschikbaar zijn.

Een `location.*`-[webhook](https://docs.anivahealth.com/nl/concepts/webhooks.md) meldt wanneer een locatie wordt toegevoegd, gewijzigd of verwijderd.

## Velden

**id** `string` *required*

UUID van de locatie. Geef dit mee als `location_id` bij het aanmaken van een afspraak.

**name** `string` *required*

Weergavenaam van de locatie.

**company\_name** `string`

Kliniek of bedrijf dat de locatie exploiteert. 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`

Plaats. Kan null zijn.

**state** `string`

Deelstaat of provincie (bepaald via de gekoppelde deelstaat van de plaats). Kan null zijn als de
plaats geen gekoppelde deelstaat heeft.

**state\_code** `string`

De [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html)-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 landnaam (bijv. `Germany`). Kan null zijn.

**country\_code** `string`

Landcode van twee letters volgens [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(bijv. `DE`, `US`). Kan null zijn.

**timezone** `string`

IANA-tijdzone-identifier voor de locatie (bijv. `Europe/Berlin`, `America/New_York`). Gebruik dit om
geplande tijden in de juiste lokale tijd te tonen. 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`

Telefoonnummer van de locatie. Kan null zijn.

**email** `string`

E-mailadres van de locatie. Kan null zijn.

**website** `string`

Website-URL van de locatie. Kan null zijn.

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

Directe link naar de locatie op Google Maps. Kan null zijn.

**image\_url** `string`

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

**open\_hours** `object`

Wekelijkse openingstijden van de locatie. Elke weekdagsleutel (`monday`–`sunday`) verwijst naar een array van
`{ open, close }`-tijdvakken in het formaat `HH:MM` (24-uurs). Een lege array betekent dat de locatie
die dag gesloten is. Kan null zijn als er geen openingstijden voor de locatie beschikbaar zijn.

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

> [!TIP]
>
> Gebruik altijd het veld `timezone` om `scheduled_at`-datums en -tijden om te zetten naar lokale tijd voordat
> je ze aan patiënten of medewerkers toont.

## Beschikbaarheid

Het veld `open_hours` hierboven beschrijft het statische wekelijkse openingsschema. Om echte boekbare tijdsloten weer te geven — en dubbele boekingen met bestaande Aniva-afspraken te voorkomen — roep je [Get Availability](https://docs.anivahealth.com/nl/api/locations/get-availability.md) aan voor de locatie en geef je het datumbereik mee dat je wilt tonen. Dat endpoint is de juiste bron van waarheid voor elke boekings-UI: het zet `open_hours` om naar het tijdslotraster van de locatie, past uitzonderingen per datum toe, haalt al geboekte afspraken eraf en past de [minimale voorlooptijd](https://docs.anivahealth.com/nl/api/appointments/create-appointment.md#minimale-boekingstermijn) toe.

## Verkoopprijzen

Een apotheek bepaalt zelf de prijs voor elk panel en elke losse biomarker die ze aan
inloopklanten verkoopt. Je ziet een prijs pas nadat de apotheek deze heeft gepubliceerd.
[List Retail Prices](https://docs.anivahealth.com/nl/api/locations/list-retail-prices.md) geeft ze terug voor elke locatie die je kunt
lezen, en [Get Retail Prices](https://docs.anivahealth.com/nl/api/locations/get-retail-prices.md) geeft ze terug voor één locatie. Beide
hebben de scope `retail_prices_view` nodig; `locations_view` bevat ze niet. Vraag beide scopes aan voor
dezelfde locaties.

Een `location.retail_prices.updated`-[webhook](https://docs.anivahealth.com/nl/concepts/webhooks.md) laat je weten wanneer een prijs verandert.
`location.created` en `location.deactivated` laten je weten wanneer een locatie erbij komt of verdwijnt. Een wijziging in
welke panels een locatie aanbiedt kan je later bereiken dan een prijswijziging, dus lees List Retail Prices
eenmaal per dag opnieuw uit.

## Voorbeeldlocatie

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "name": "Mitte Health Center",
  "company_name": "Aniva Berlin GmbH",
  "street": "Friedrichstraße",
  "house_number": "100",
  "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.531677,
  "longitude": 13.388042,
  "contact_phone": "+493012345678",
  "email": "berlin@anivahealth.com",
  "website": "https://anivahealth.com",
  "google_maps_url": "https://maps.google.com/?q=Friedrichstra%C3%9Fe+100+Berlin",
  "image_url": "https://anivahealth.com/images/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.