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

> Preia orele de începere ale intervalelor disponibile pentru programare la o singură locație

Returnează orele de început ale intervalelor disponibile pentru o singură locație în fereastra solicitată. Intervalele sunt
generate din `open_hours` al locației, fără datele blocate global / per locație și
fără programările Aniva deja rezervate, astfel încât rezultatul reflectă ce pot rezerva concret pacienții tăi
pe partea de client.

Necesită scope-ul `appointments_schedule`. Locația trebuie să facă parte și din contextul de acces pe grupuri de locații al cheii tale API.

> [!NOTE]
>
> Folosește acest endpoint în loc să deduci disponibilitatea din câmpul static `open_hours` returnat de [Listare
> locații](https://docs.anivahealth.com/ro/api/locations/list-locations.md) — doar acest endpoint ține cont de programările active,
> excepțiile de program pe date specifice și [preavizul minim](https://docs.anivahealth.com/ro/api/appointments/create-appointment.md#preaviz-minim)
> de 12 ore din locațiile operate de Aniva. Fiecare
> interval returnat aici poate fi rezervat ca atare.

Răspunsurile conțin `Cache-Control: private, max-age=30, stale-while-revalidate=60`, deci un browser poate
servi un răspuns din cache timp de până la \~30 de secunde — un interval rezervat în această fereastră poate părea încă
disponibil până la următoarea reîmprospătare. Afișează conflictele și în momentul rezervării.

## Parametri de cale

**id** `string` *required*

Identificatorul locației (UUID). Folosește câmpul `id` din [Listare locații](https://docs.anivahealth.com/ro/api/locations/list-locations.md).

## Parametri de interogare

**start\_date** `string`

Începutul inclusiv al ferestrei în format `YYYY-MM-DD` (interpretat în `timezone`). Opțional. Valoarea implicită este
**astăzi** când nu este furnizată nicio dată sau **`end_date − 30 days`** când este furnizat doar `end_date`.
Datele din trecut sunt ajustate automat la ziua de astăzi.

**end\_date** `string`

Sfârșitul inclusiv al ferestrei în format `YYYY-MM-DD` (interpretat în `timezone`). Opțional. Valoarea implicită este
**astăzi + 30 de zile** când nu este furnizată nicio dată sau **`start_date + 30 days`** când este furnizat doar
`start_date`. Trebuie să fie egală cu sau după `start_date` și în limita a 90 de zile față de astăzi.

**timezone** `string`

Fus orar IANA (de ex., `Europe/Berlin`) folosit pentru a interpreta `start_date` / `end_date` și a grupa
intervalele pe date calendaristice. Opțional — implicit este fusul orar al locației. Orele de început ale intervalelor
sunt redate întotdeauna ca momente UTC (`Z`) și nu se modifică în funcție de acest parametru —
grila de intervale este proiectată întotdeauna din fusul orar al locației; parametrul afectează doar
ziua calendaristică în care este grupat un interval. Intrările pe zile din răspuns acoperă exact
`start_date`..`end_date` ca zile calendaristice în acest fus orar. Omite-l dacă nu afișezi selectorul
în alt fus orar.

## Răspuns

La succes, API-ul returnează `200 OK` cu un singur obiect de disponibilitate.

**location\_id** `string` *required*

Identificatorul locației, preluat din cerere.

**timezone** `string` *required*

Fusul orar IANA în care este redat răspunsul (de ex., `Europe/Berlin`) — preia parametrul de interogare `timezone`
dacă este furnizat, altfel fusul orar al locației.

**slot\_interval\_minutes** `integer`

Distanța în minute dintre orele de început ale intervalelor disponibile consecutive. Pasul grilei configurate pentru locație —
fiecare interval din `availability` se aliniază pe această grilă. Este `null` doar când locația nu are o configurare
de programare. **Nu reprezintă durata programării:** rezervările care se suprapun cu ore de început diferite nu intră
în conflict; doar coliziunile la aceeași oră exactă de început contează pentru concurență.

**availability** `array` *required*

Intervale disponibile pe zile. Zilele fără intervale disponibile sunt omise pentru a păstra răspunsul compact.
Fiecare intrare conține:

**intrare pe zi**

**date** `string` *required*

Data calendaristică în fusul orar `timezone` al răspunsului (`YYYY-MM-DD`).

**slots** `array` *required*

Orele de început ale intervalelor ca momente UTC (ISO 8601 cu sufixul `Z`), ordonate crescător.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | ID de locație invalid, format invalid pentru dată sau fus orar, `end_date` înainte de `start_date` sau `end_date` cu peste 90 de zile în viitor. |
| `403` | Interzis — lipsește scope-ul `appointments_schedule` sau locația nu intră în contextul tău de acces. |
| `404` | Locația nu a fost găsită sau este inactivă. |
| `500` | Eroare internă de server. |

```bash cURL theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/locations/b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b/availability?start_date=2026-05-01&end_date=2026-05-07' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "timezone": "Europe/Berlin",
  "slot_interval_minutes": 15,
  "availability": [
    {
      "date": "2026-05-04",
      "slots": ["2026-05-04T07:00:00Z", "2026-05-04T07:15:00Z", "2026-05-04T07:30:00Z"]
    },
    {
      "date": "2026-05-05",
      "slots": ["2026-05-05T06:00:00Z", "2026-05-05T06:15:00Z"]
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.