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

# Standort abrufen

> Einen Teststandort anhand seiner ID abrufen

Rufe einen Standort ab. Er hat dieselbe Struktur wie ein Eintrag aus
[Standorte auflisten](https://docs.anivahealth.com/de/api/locations/list-locations.md). Die `url` eines
[Webhook](https://docs.anivahealth.com/de/concepts/webhooks.md)-Events vom Typ `location.*` verweist hierher.

Erfordert den Scope `locations_view` oder `appointments_schedule`.

## Anfrage

### Pfadparameter

**id** `string` *required*

Standort-ID (UUID).

## Antwort

Bei Erfolg gibt die API `200 OK` mit dem Standortobjekt zurück.

**id** `string` *required*

Eindeutige Standortkennung (UUID).

**name** `string` *required*

Anzeigename des Standorts.

**company\_name** `string`

Name des Unternehmens oder der Klinik. Kann `null` sein.

**street** `string`

Straßenname ohne Hausnummer. Kann `null` sein.

**house\_number** `string`

Hausnummer. Kann `null` sein.

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

Zusätzliche Adresszeile – c/o, Gebäude oder Etage. Kann `null` sein.

**city** `string`

Stadt. Kann `null` sein.

**state** `string`

Bundesland oder Provinz. Kann `null` sein, wenn der Stadt kein Bundesland zugeordnet ist (z. B.
Stadtstaaten oder nicht zugeordnete Importe).

**state\_code** `string`

ISO-3166-2-Code des Bundeslands ohne Länderpräfix (z. B. `BW` für Baden-Württemberg). Kann `null`
sein.

**postal\_code** `string`

Postleitzahl. Kann `null` sein.

**country\_name** `string`

Vollständiger Ländername. Kann `null` sein.

**country\_code** `string`

Ländercode nach ISO 3166-1 alpha-2 (z. B. `DE`, `US`, `FI`). Kann `null` sein.

**timezone** `string`

IANA-Zeitzonenkennung (z. B. `Europe/Berlin`). Kann `null` sein.

**latitude** `number`

Breitengrad der Adresse in Dezimalgrad (WGS 84). Kann `null` sein.

**longitude** `number`

Längengrad der Adresse in Dezimalgrad (WGS 84). Kann `null` sein.

**contact\_phone** `string`

Kontakttelefonnummer des Standorts. Kann `null` sein.

**email** `string`

Kontakt-E-Mail-Adresse. Kann `null` sein.

**website** `string`

Website-URL. Kann `null` sein.

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

Google-Maps-Link zum Standort. Kann `null` sein.

**image\_url** `string`

URL eines Standortfotos. Kann `null` sein.

**open\_hours** `object`

Wöchentliche Öffnungszeiten. Jeder Wochentagsschlüssel (`monday`–`sunday`) verweist auf ein Array
mit Zeitspannen aus Öffnungs- und Schließzeit. Ein leeres Array bedeutet, dass der Standort an
diesem Tag geschlossen ist. Das gesamte Objekt ist `null`, wenn für den Standort keine
Öffnungszeiten verfügbar sind.

**Zeitspanne pro Tag**

**open** `string` *required*

Öffnungszeit im 24-Stunden-Format (`HH:MM`).

**close** `string` *required*

Schließzeit im 24-Stunden-Format (`HH:MM`).

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

Wie das Blut bei einem Termin hier abgenommen wird, sofern der Termin keine eigene `draw_method`
festlegt: `capillary` (Fingerkuppe oder Oberarm, in Mikrogefäße) oder `venous` (aus der Vene, in
Röhrchen).

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

Die Abnahmemethoden, für die der Standort Gefäße vorrätig hat, sortiert. Ein Termin hier kann nur
eine davon als `draw_method` festlegen.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Die `id` ist keine UUID. |
| `401` | Der API-Schlüssel fehlt oder ist ungültig. |
| `403` | Dein API-Schlüssel hat nicht den erforderlichen Scope. |
| `404` | Der Standort existiert nicht, ist inaktiv oder liegt außerhalb deines Zugriffs. |
| `500` | Interner Serverfehler. |

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