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

# Список локацій

> Отримати всі локації для здачі аналізів, доступні для твого API-ключа

Отримай усі активні локації для аналізів, доступні твоєму API-ключу. Використовуй `id` повернутої локації, коли створюєш запис через [Створити запис](https://docs.anivahealth.com/uk/api/appointments/create-appointment.md).

Потрібен дозвіл `locations_view` або `appointments_schedule`.

## Запит

Цей ендпойнт не приймає параметрів запиту.

## Відповідь

У разі успіху API повертає `200 OK` із масивом об’єктів локацій.

**id** `string` *required*

Унікальний ідентифікатор локації (UUID).

**name** `string` *required*

Назва локації для відображення.

**company\_name** `string`

Назва компанії або клініки. Може бути `null`.

**street** `string`

Назва вулиці без номера будинку. Може бути `null`.

**house\_number** `string`

Номер будинку. Може бути `null`.

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

Додатковий рядок адреси — c/o, корпус або поверх. Може бути `null`.

**city** `string`

Місто. Може бути `null`.

**state** `string`

Штат або провінція. Може бути `null`, якщо місто не прив’язане до регіону (наприклад, міста-держави або
незіставлений імпорт).

**state\_code** `string`

Код штату за ISO 3166-2 без префікса країни (наприклад, `BW` для Баден-Вюртембергу). Може бути
`null`.

**postal\_code** `string`

Поштовий індекс або ZIP-код. Може бути `null`.

**country\_name** `string`

Повна назва країни. Може бути `null`.

**country\_code** `string`

Код країни за ISO 3166-1 alpha-2 (наприклад, `DE`, `US`, `FI`). Може бути `null`.

**timezone** `string`

Ідентифікатор часового поясу IANA (наприклад, `Europe/Berlin`). Може бути `null`.

**latitude** `number`

Широта адреси в десяткових градусах (WGS 84). Може бути `null`.

**longitude** `number`

Довгота адреси в десяткових градусах (WGS 84). Може бути `null`.

**contact\_phone** `string`

Контактний номер телефону локації. Може бути `null`.

**email** `string`

Контактна електронна адреса. Може бути `null`.

**website** `string`

URL вебсайту. Може бути `null`.

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

Посилання на локацію в Google Maps. Може бути `null`.

**image\_url** `string`

URL фото локації. Може бути `null`.

**open\_hours** `object`

Тижневий графік роботи. Кожен ключ дня тижня (`monday`–`sunday`) відповідає масиву проміжків часу
відкриття та закриття. Порожній масив означає, що цього дня локація зачинена. Увесь об’єкт дорівнює `null`,
якщо графік роботи для локації недоступний.

**часовий проміжок на день**

**open** `string` *required*

Час відкриття у форматі `HH:MM` (24-годинному).

**close** `string` *required*

Час закриття у форматі `HH:MM` (24-годинному).

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

Як тут проводять забір крові під час запису, якщо в записі не вказано власний `draw_method`:
`capillary` (з пальця або плеча в мікроконтейнери) або `venous` (з вени в пробірки).

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

Способи забору крові, для яких у локації є контейнери, у відсортованому порядку. У записі тут можна
вказати лише один із них як `draw_method`.

## Відповіді з помилками

| Статус | Опис |
| - | - |
| `403` | Доступ заборонено — твій API-ключ не має доступу до цієї операції. |
| `500` | Внутрішня помилка сервера. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --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"]
  },
  {
    "id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c",
    "name": "Aniva Helsinki Central",
    "company_name": "Aniva Oy",
    "street": "Mannerheimintie",
    "house_number": "12",
    "address_line_2": null,
    "city": "Helsinki",
    "state": "Uusimaa",
    "state_code": "18",
    "postal_code": "00100",
    "country_name": "Finland",
    "country_code": "FI",
    "timezone": "Europe/Helsinki",
    "latitude": 60.169405,
    "longitude": 24.938365,
    "contact_phone": "+358912345678",
    "email": "helsinki@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": "https://maps.google.com/?q=Mannerheimintie+12+Helsinki",
    "image_url": "https://cdn.anivahealth.com/locations/helsinki-central.jpg",
    "open_hours": {
      "monday": [{ "open": "07:30", "close": "17:00" }],
      "tuesday": [{ "open": "07:30", "close": "17:00" }],
      "wednesday": [{ "open": "07:30", "close": "17:00" }],
      "thursday": [{ "open": "07:30", "close": "17:00" }],
      "friday": [{ "open": "07:30", "close": "15: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.