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

# Helyszín lekérése

> Kérj le egy vizsgálati helyszínt az azonosítója alapján

Egy helyszín lekérdezése. Felépítése megegyezik a
[Helyszínek listázása](https://docs.anivahealth.com/hu/api/locations/list-locations.md) végpont egy-egy elemével. Egy `location.*`
[webhook](https://docs.anivahealth.com/hu/concepts/webhooks.md)-esemény `url` mezője ide mutat.

A `locations_view` vagy az `appointments_schedule` scope szükséges hozzá.

## Kérés

### Útvonalparaméterek

**id** `string` *required*

Helyszínazonosító (UUID).

## Válasz

Sikeres kérés esetén az API `200 OK` választ ad vissza a helyszínobjektummal.

**id** `string` *required*

Egyedi helyszínazonosító (UUID).

**name** `string` *required*

A helyszín megjelenített neve.

**company\_name** `string`

Cég- vagy klinikanév. Lehet `null`.

**street** `string`

Utcanév, házszám nélkül. Lehet `null`.

**house\_number** `string`

Házszám. Lehet `null`.

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

További címsor – c/o, épület vagy emelet. Lehet `null`.

**city** `string`

Város. Lehet `null`.

**state** `string`

Állam vagy tartomány. Lehet `null`, ha a városhoz nem tartozik állam (pl. városállamok vagy
leképezetlen importok esetén).

**state\_code** `string`

Az állam ISO 3166-2 kódja az ország-előtag nélkül (pl. `BW` Baden-Württemberg esetén). Lehet
`null`.

**postal\_code** `string`

Irányítószám. Lehet `null`.

**country\_name** `string`

Az ország teljes neve. Lehet `null`.

**country\_code** `string`

ISO 3166-1 alpha-2 országkód (pl. `DE`, `US`, `FI`). Lehet `null`.

**timezone** `string`

IANA időzóna-azonosító (pl. `Europe/Berlin`). Lehet `null`.

**latitude** `number`

A cím földrajzi szélessége decimális fokban (WGS 84). Lehet `null`.

**longitude** `number`

A cím földrajzi hosszúsága decimális fokban (WGS 84). Lehet `null`.

**contact\_phone** `string`

A helyszín kapcsolattartási telefonszáma. Lehet `null`.

**email** `string`

Kapcsolattartási e-mail-cím. Lehet `null`.

**website** `string`

Weboldal URL-címe. Lehet `null`.

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

A helyszín Google Maps-linkje. Lehet `null`.

**image\_url** `string`

A helyszínről készült fotó URL-címe. Lehet `null`.

**open\_hours** `object`

Heti nyitvatartás. A hét egyes napjaihoz tartozó kulcsok (`monday`–`sunday`) nyitási/zárási
időtartományok tömbjére mutatnak. Az üres tömb azt jelenti, hogy a helyszín aznap zárva van. A
teljes objektum `null`, ha a helyszín nyitvatartása nem érhető el.

**napi időtartomány**

**open** `string` *required*

Nyitási idő `HH:MM` (24 órás) formátumban.

**close** `string` *required*

Zárási idő `HH:MM` (24 órás) formátumban.

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

A vérvétel alapértelmezett módja az itteni időpontokon, ha az időpont nem ad meg saját
`draw_method` értéket: `capillary` (ujjbegyből vagy felkarból, mikrocsövekbe) vagy `venous`
(vénából, csövekbe).

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

Azok a vérvételi módok, amelyekhez a helyszín tart készleten mintavételi tartályokat, rendezve.
Egy itteni időpont `draw_method` értéke csak ezek közül valamelyik lehet.

## Hibaválaszok

| Állapotkód | Leírás |
| - | - |
| `400` | Az `id` nem UUID. |
| `401` | Az API-kulcs hiányzik vagy érvénytelen. |
| `403` | Az API-kulcsod nem rendelkezik a szükséges scope-pal. |
| `404` | A helyszín nem létezik, inaktív, vagy nincs hozzá hozzáférésed. |
| `500` | Belső szerverhiba. |

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