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

# Iegūt pieejamību

> Iegūt rezervējamo laiku sākumus vienai atrašanās vietai

Atgriež vienas vietas rezervējamu laiku sākumus pieprasītajā laika posmā. Laiki tiek
ģenerēti no vietas `open_hours`, izlaižot globālos un konkrētās vietas bloķētos datumus un
atņemot jau rezervētus Aniva pierakstus, tāpēc rezultāts atspoguļo to, ko tavi pacienti
reāli var rezervēt klienta pusē.

Nepieciešams tvērums `appointments_schedule`. Vietai jāietilpst arī tavas API atslēgas vietu grupas piekļuves kontekstā.

> [!NOTE]
>
> Izmanto šo galapunktu, nevis aprēķini pieejamību no statiskā `open_hours`, ko atgriež [Vietu
> saraksts](https://docs.anivahealth.com/lv/api/locations/list-locations.md) — tikai šis galapunkts ņem vērā aktuālās rezervācijas,
> grafika izņēmumus konkrētiem datumiem un 12 stundu [minimālo
> iepriekšējo pieteikšanās laiku](https://docs.anivahealth.com/lv/api/appointments/create-appointment.md#minimalais-pieteiksanas-laiks) Aniva pārvaldītajās vietās. Katrs
> šeit atgrieztais laiks ir uzreiz rezervējams.

Atbildes satur `Cache-Control: private, max-age=30, stale-while-revalidate=60`, tāpēc pārlūkprogramma var
pasniegt kešotus datus līdz \~30 sekundēm — šajā logā rezervēts laiks līdz nākamajai atsvaidzināšanai joprojām var rādīties
kā pieejams. Apstrādā konfliktus arī rezervēšanas brīdī.

## Ceļa parametri

**id** `string` *required*

Vietas identifikators (UUID). Izmanto `id` no [Vietu saraksts](https://docs.anivahealth.com/lv/api/locations/list-locations.md).

## Vaicājuma parametri

**start\_date** `string`

Laika posma sākums (ieskaitot) formātā `YYYY-MM-DD` (interpretēts `timezone` laika joslā). Neobligāts. Pēc noklusējuma
**šodiena**, ja nav norādīts neviens datums, vai **`end_date − 30 days`**, ja norādīts tikai `end_date`.
Pagātnes datumi nemanāmi tiek pielīdzināti šodienai.

**end\_date** `string`

Laika posma beigas (ieskaitot) formātā `YYYY-MM-DD` (interpretēts `timezone` laika joslā). Neobligāts. Pēc noklusējuma
**šodiena + 30 dienas**, ja nav norādīts neviens datums, vai **`start_date + 30 days`**, ja norādīts tikai
`start_date`. Jābūt vienādam ar `start_date` vai vēlākam un 90 dienu robežās no šodienas.

**timezone** `string`

IANA laika josla (piem., `Europe/Berlin`), ko izmanto `start_date` / `end_date` interpretēšanai un
laiku grupēšanai pa kalendāra datumiem. Neobligāta — pēc noklusējuma tiek izmantota pašas vietas laika josla. Paši laiku sākumi
vienmēr tiek attēloti kā UTC brīži (`Z`) un ar šo parametru nekad nemainās —
laiku režģis vienmēr tiek projicēts no pašas vietas laika joslas; parametrs ietekmē tikai to, kurai
kalendāra dienai laiks tiek pieskaitīts. Dienu ieraksti atbildē aptver tieši
`start_date`..`end_date` kā kalendāra dienas šajā laika joslā. Izlaid to, ja vien laika izvēlni neattēlo
citā laika joslā.

## Atbilde

Veiksmīga pieprasījuma gadījumā API atgriež `200 OK` ar vienu pieejamības objektu.

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

Atgrieztais vietas identifikators.

**timezone** `string` *required*

IANA laika josla, kurā attēlota atbilde (piem., `Europe/Berlin`) — atkārto vaicājuma parametru `timezone`,
ja tas ir norādīts, pretējā gadījumā izmanto pašas vietas laika joslu.

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

Atstarpe minūtēs starp secīgu rezervējamu laiku sākumiem. Vietai konfigurētais režģa solis —
katrs laiks masīvā `availability` atbilst šim režģim. `null` tikai tad, ja vietai nav plānošanas
konfigurācijas. **Tas nav pieraksta ilguma logs:** pārklājošas rezervācijas ar atšķirīgiem sākuma laikiem
nekonfliktē; pie vienlaicīguma tiek skaitītas tikai precīzas sākuma laika sakritības.

**availability** `array` *required*

Rezervējamie laiki pa dienām. Dienas bez rezervējamajiem laikiem tiek izlaistas, lai datu apjoms būtu mazāks.
Katram ierakstam ir:

**dienas ieraksts**

**date** `string` *required*

Kalendāra datums atbildes `timezone` laika joslā (`YYYY-MM-DD`).

**slots** `array` *required*

Laiku sākumi kā UTC brīži (ISO 8601 ar `Z` sufiksu) augošā secībā.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Nederīgs vietas ID, nederīgs datuma vai laika joslas formāts, `end_date` pirms `start_date` vai `end_date` vairāk nekā 90 dienas nākotnē. |
| `403` | Pieeja liegta — trūkst `appointments_schedule` tvēruma vai vieta ir ārpus tava piekļuves konteksta. |
| `404` | Vieta nav atrasta vai ir neaktīva. |
| `500` | Iekšēja servera kļūda. |

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