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

# Obtén una ubicació

> Recupera una ubicació de prova pel seu ID

Recupera una ubicació. Té la mateixa estructura que una entrada de
[Llista les ubicacions](https://docs.anivahealth.com/ca/api/locations/list-locations.md). L'`url` d'un esdeveniment
[webhook](https://docs.anivahealth.com/ca/concepts/webhooks.md) `location.*` apunta aquí.

Requereix l'àmbit `locations_view` o `appointments_schedule`.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

ID de la ubicació (UUID).

## Resposta

En cas d'èxit, l'API retorna `200 OK` amb l'objecte d'ubicació.

**id** `string` *required*

Identificador únic de la ubicació (UUID).

**name** `string` *required*

Nom visible de la ubicació.

**company\_name** `string`

Nom de l'empresa o clínica. Pot ser `null`.

**street** `string`

Nom del carrer, sense el número. Pot ser `null`.

**house\_number** `string`

Número de carrer. Pot ser `null`.

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

Línia d'adreça addicional — c/o, edifici o pis. Pot ser `null`.

**city** `string`

Ciutat. Pot ser `null`.

**state** `string`

Estat o província. Pot ser `null` quan la ciutat no té cap estat associat (p. ex., ciutats estat o
importacions sense assignar).

**state\_code** `string`

Codi ISO 3166-2 de l'estat sense el prefix del país (p. ex., `BW` per a Baden-Württemberg). Pot ser
`null`.

**postal\_code** `string`

Codi postal o ZIP. Pot ser `null`.

**country\_name** `string`

Nom complet del país. Pot ser `null`.

**country\_code** `string`

Codi de país ISO 3166-1 alfa-2 (p. ex., `DE`, `US`, `FI`). Pot ser `null`.

**timezone** `string`

Identificador de zona horària IANA (p. ex., `Europe/Berlin`). Pot ser `null`.

**latitude** `number`

Latitud de l'adreça en graus decimals (WGS 84). Pot ser `null`.

**longitude** `number`

Longitud de l'adreça en graus decimals (WGS 84). Pot ser `null`.

**contact\_phone** `string`

Telèfon de contacte de la ubicació. Pot ser `null`.

**email** `string`

Adreça electrònica de contacte. Pot ser `null`.

**website** `string`

URL del lloc web. Pot ser `null`.

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

Enllaç de Google Maps de la ubicació. Pot ser `null`.

**image\_url** `string`

URL d'una foto de la ubicació. Pot ser `null`.

**open\_hours** `object`

Horari d'obertura setmanal. Cada clau de dia de la setmana (`monday`–`sunday`) correspon a una
matriu de franges horàries d'obertura i tancament. Una matriu buida indica que la ubicació està
tancada aquell dia. Tot l'objecte és `null` quan no hi ha horaris disponibles per a la ubicació.

**franja horària per dia**

**open** `string` *required*

Hora d'obertura en format `HH:MM` (24 h).

**close** `string` *required*

Hora de tancament en format `HH:MM` (24 h).

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

Com es fa l'extracció de sang en una cita aquí, llevat que la cita defineixi el seu propi
`draw_method`: `capillary` (punta del dit o part superior del braç, en microtubs) o `venous` (de
la vena, en tubs).

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

Els mètodes d'extracció per als quals la ubicació disposa de contenidors, ordenats. Una cita aquí
només pot definir un d'aquests com a `draw_method`.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | L'`id` no és un UUID. |
| `401` | Falta la clau API o no és vàlida. |
| `403` | La teva clau API no té l'àmbit necessari. |
| `404` | La ubicació no existeix, està inactiva o queda fora del teu accés. |
| `500` | Error intern del 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.