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

# Получить локацию

> Получить одну локацию для сдачи анализов по ее ID

Запроси одну локацию. Её структура совпадает с элементом
[Списка локаций](https://docs.anivahealth.com/ru/api/locations/list-locations.md). Сюда ведёт `url` события
[вебхука](https://docs.anivahealth.com/ru/concepts/webhooks.md) `location.*`.

Требуется scope `locations_view` или `appointments_schedule`.

## Запрос

### Параметры пути

**id** `string` *required*

ID локации (UUID).

## Ответ

В случае успеха 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`.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `400` | `id` не является UUID. |
| `401` | API-ключ отсутствует или недействителен. |
| `403` | У твоего API-ключа нет нужной области доступа. |
| `404` | Локация не существует, неактивна или недоступна тебе. |
| `500` | Внутренняя ошибка сервера. |

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