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

# Obter local

> Obter um local de análises pelo ID

Obtém uma localização. Tem o mesmo formato que uma entrada de
[Listar localizações](https://docs.anivahealth.com/pt/api/locations/list-locations.md). O `url` de um evento `location.*` de
[webhook](https://docs.anivahealth.com/pt/concepts/webhooks.md) aponta para aqui.

Requer o scope `locations_view` ou `appointments_schedule`.

## Pedido

### Parâmetros de caminho

**id** `string` *required*

ID da localização (UUID).

## Resposta

Em caso de sucesso, a API devolve `200 OK` com o objeto de localização.

**id** `string` *required*

Identificador único da localização (UUID).

**name** `string` *required*

Nome de apresentação da localização.

**company\_name** `string`

Nome da empresa ou clínica. Pode ser `null`.

**street** `string`

Nome da rua, sem o número da porta. Pode ser `null`.

**house\_number** `string`

Número de porta. Pode ser `null`.

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

Linha de morada adicional — c/o, edifício ou andar. Pode ser `null`.

**city** `string`

Cidade. Pode ser `null`.

**state** `string`

Estado ou província. Pode ser `null` quando a cidade não tem um estado associado (p. ex.,
cidades-estado ou importações não mapeadas).

**state\_code** `string`

O código ISO 3166-2 do estado sem o prefixo do país (p. ex., `BW` para Baden-Württemberg). Pode
ser `null`.

**postal\_code** `string`

Código postal ou ZIP. Pode ser `null`.

**country\_name** `string`

Nome completo do país. Pode ser `null`.

**country\_code** `string`

Código de país ISO 3166-1 alfa-2 (p. ex., `DE`, `US`, `FI`). Pode ser `null`.

**timezone** `string`

Identificador de fuso horário IANA (p. ex., `Europe/Berlin`). Pode ser `null`.

**latitude** `number`

Latitude da morada em graus decimais (WGS 84). Pode ser `null`.

**longitude** `number`

Longitude da morada em graus decimais (WGS 84). Pode ser `null`.

**contact\_phone** `string`

Número de telefone de contacto do local. Pode ser `null`.

**email** `string`

Endereço de e-mail de contacto. Pode ser `null`.

**website** `string`

URL do site. Pode ser `null`.

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

Ligação do Google Maps para o local. Pode ser `null`.

**image\_url** `string`

URL de uma foto do local. Pode ser `null`.

**open\_hours** `object`

Horário de funcionamento semanal. Cada chave de dia da semana (`monday`–`sunday`) corresponde a
um array de intervalos de abertura/fecho. Um array vazio significa que o local está fechado nesse
dia. Todo o objeto é `null` quando o horário não está disponível para o local.

**intervalo horário por dia**

**open** `string` *required*

Hora de abertura no formato `HH:MM` (24h).

**close** `string` *required*

Hora de fecho no formato `HH:MM` (24h).

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

Como o sangue é colhido numa marcação neste local, a menos que a marcação defina o seu próprio
`draw_method`: `capillary` (ponta do dedo ou parte superior do braço, para microtubos) ou
`venous` (da veia, para tubos).

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

Os métodos de colheita para os quais o local tem recipientes em stock, ordenados. Uma marcação
neste local só pode definir um destes como o seu `draw_method`.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `400` | O `id` não é um UUID. |
| `401` | A chave de API está em falta ou é inválida. |
| `403` | A tua chave de API não tem o scope necessário. |
| `404` | O local não existe, está inativo ou está fora do teu acesso. |
| `500` | Erro interno do servidor. |

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