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

# Obține locația

> Preia o locație de testare după ID-ul ei

Obține o locație. Are aceeași structură ca o intrare din
[Listare locații](https://docs.anivahealth.com/ro/api/locations/list-locations.md). Câmpul `url` al unui eveniment
[webhook](https://docs.anivahealth.com/ro/concepts/webhooks.md) de tip `location.*` trimite aici.

Necesită scope-ul `locations_view` sau `appointments_schedule`.

## Cerere

### Parametri de cale

**id** `string` *required*

ID-ul locației (UUID).

## Răspuns

La succes, API-ul returnează `200 OK` cu obiectul locației.

**id** `string` *required*

Identificator unic al locației (UUID).

**name** `string` *required*

Numele afișat al locației.

**company\_name** `string`

Numele companiei sau al clinicii. Poate fi `null`.

**street** `string`

Numele străzii, fără numărul casei. Poate fi `null`.

**house\_number** `string`

Numărul clădirii. Poate fi `null`.

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

Linie suplimentară de adresă — c/o, clădire sau etaj. Poate fi `null`.

**city** `string`

Oraș. Poate fi `null`.

**state** `string`

Stat sau provincie. Poate fi `null` când orașul nu are un stat asociat (de ex., orașe-stat sau
importuri nemapate).

**state\_code** `string`

Codul ISO 3166-2 al statului fără prefixul de țară (de ex., `BW` pentru Baden-Württemberg). Poate
fi `null`.

**postal\_code** `string`

Cod poștal sau cod ZIP. Poate fi `null`.

**country\_name** `string`

Numele complet al țării. Poate fi `null`.

**country\_code** `string`

Codul de țară ISO 3166-1 alpha-2 (de ex., `DE`, `US`, `FI`). Poate fi `null`.

**timezone** `string`

Identificatorul IANA al fusului orar (de ex., `Europe/Berlin`). Poate fi `null`.

**latitude** `number`

Latitudinea adresei în grade zecimale (WGS 84). Poate fi `null`.

**longitude** `number`

Longitudinea adresei în grade zecimale (WGS 84). Poate fi `null`.

**contact\_phone** `string`

Numărul de telefon de contact al locației. Poate fi `null`.

**email** `string`

Adresa de email de contact. Poate fi `null`.

**website** `string`

URL-ul site-ului web. Poate fi `null`.

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

Linkul Google Maps pentru locație. Poate fi `null`.

**image\_url** `string`

URL-ul unei fotografii a locației. Poate fi `null`.

**open\_hours** `object`

Programul săptămânal. Fiecare cheie de zi a săptămânii (`monday`–`sunday`) corespunde unui array
de intervale orare de deschidere/închidere. Un array gol înseamnă că locația este închisă în acea
zi. Întregul obiect este `null` când programul nu este disponibil pentru locație.

**interval orar pe zi**

**open** `string` *required*

Ora de deschidere în format `HH:MM` (24h).

**close** `string` *required*

Ora de închidere în format `HH:MM` (24h).

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

Modul în care se recoltează sângele la o programare aici, dacă programarea nu setează propriul
`draw_method`: `capillary` (din vârful degetului sau din partea superioară a brațului, în
microtuburi) sau `venous` (din venă, în eprubete).

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

Metodele de recoltare pentru care locația are recipiente pe stoc, sortate. O programare aici
poate seta doar una dintre acestea ca `draw_method`.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | `id` nu este un UUID. |
| `401` | Cheia API lipsește sau nu este validă. |
| `403` | Cheia ta API nu are scope-ul necesar. |
| `404` | Locația nu există, este inactivă sau nu ai acces la ea. |
| `500` | Eroare internă de server. |

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