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

# Listează programările

> Preia programările pentru recoltare de sânge accesibile cheii tale API

Preia o listă de programări pentru recoltare de sânge. Fiecare programare include profilul de pacient încorporat.

Filtrele se combină:

* `date` returnează programările dintr-o singură zi calendaristică. Ziua este ziua locală a locației fiecărei programări, așa că o recoltare de sânge la 23:30 în Berlin contează la data ei din Berlin.
* `location_id` returnează programările de la o singură locație de testare.
* `profile_id` fără `date` returnează toate programările pentru acel profil, fără restricție de timp.
* Fără `profile_id` și fără `date`, se aplică intervalul de timp implicit: ultimele 2 luni până peste 1 lună.

Necesită permisiunea `appointments_view` sau `appointments_schedule`.

## Cerere

### Parametri de interogare

**profile\_id** `string`

Filtrează după UUID-ul profilului. Când este furnizat, sunt returnate toate programările pentru acest profil, indiferent
de data programării. Când lipsește, se aplică intervalul de timp implicit.

**location\_id** `string`

Filtrează după UUID-ul locației de testare.

**date** `string`

Zi calendaristică în format `YYYY-MM-DD`, în fusul orar al locației fiecărei programări. Înlocuiește
intervalul de timp implicit. Rezultatele sunt sortate după `scheduled_at`, cele mai devreme primele.

## Răspuns

În caz de succes, API-ul returnează `200 OK` cu un array de obiecte programare.

**id** `string` *required*

Identificatorul unic al programării (UUID).

**profile\_id** `string` *required*

UUID-ul profilului căruia îi aparține această programare.

**location\_id** `string`

UUID-ul locației de testare unde are loc recoltarea de sânge.

**scheduled\_at** `string`

Data și ora programării în format UTC (ISO 8601 cu sufixul `Z`, de ex.
`2026-05-15T10:30:00Z`). Poate fi `null`.

**status** `string` *required*

Statusul curent al programării. Una dintre valorile `pending`, `confirmed`, `blood_drawn` sau `cancelled`.
Detaliile privind finalizarea rezultatelor de laborator se obțin din [Obține rezultatele](https://docs.anivahealth.com/ro/api/appointments/get-results.md);
evoluția detaliată a expedierii se obține din fiecare intrare din lista inline `shipments` (vezi mai jos),
urmată de [Obține expedierea](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Motivul în text liber înregistrat la anularea programării (de ex. neprezentare, anulare tardivă,
„Eșuat. Necesită repetare”). Este `null` dacă `status` nu este `cancelled`.

**results\_ready\_emails** `string[]` *required*

Adresele care primesc fiecare câte un e-mail când toate rezultatele de laborator sunt finale, cu
litere mici. Gol când este dezactivat. Vezi
[E-mailuri pentru rezultate gata](https://docs.anivahealth.com/ro/concepts/results.md#e-mailuri-cand-rezultatele-sunt-gata).

**draw\_method** `string` *required*

Cum se face recoltarea de sânge: `capillary` (din vârful degetului sau partea superioară a brațului, în
microtainere) sau `venous` (din venă, în eprubete). Este metoda setată pe programare sau
`default_draw_method` al [locației](https://docs.anivahealth.com/ro/concepts/locations.md) acesteia. După recoltarea de sânge, este
metoda care a fost folosită.

**created\_at** `string` *required*

Timestamp ISO 8601 al creării programării.

**updated\_at** `string`

Timestamp ISO 8601 al ultimei actualizări. Poate fi `null`.

**profile** `object` *required*

Profilul pacientului asociat cu această programare.

**profil**

**id** `string`

Identificatorul unic al profilului (UUID).

**handle** `string`

Handle-ul profilului sau numele de utilizator. Poate fi `null`.

**first\_name** `string`

Prenume. Poate fi `null`.

**last\_name** `string`

Nume de familie. Poate fi `null`.

**email** `string`

Adresă de e-mail. Poate fi `null`.

**phone** `string`

Număr de telefon în format E.164. Poate fi `null`.

**sex** `integer`

Sex biologic conform ISO/IEC 5218. Poate fi `null`.

**date\_of\_birth** `string`

Data nașterii în format `YYYY-MM-DD`. Poate fi `null`.

**height** `number`

Înălțime în centimetri. Poate fi `null`.

**weight** `number`

Greutate în kilograme. Poate fi `null`.

**language** `string`

Limba preferată: unul dintre cele 32 de coduri din [Creează profil](https://docs.anivahealth.com/ro/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Indică dacă acest profil primește e-mailuri tranzacționale (programatice). Poate fi `null`.

**created\_at** `string`

Timestamp ISO 8601 al creării profilului.

**updated\_at** `string`

Timestamp ISO 8601 al ultimei actualizări a profilului. Poate fi `null`.

**panels** `AppointmentPanel[]` *required*

Panelurile atașate în prezent acestei programări. Exclude atașările anulate. Consultă detaliile
panelului (nume, biomarkeri) prin [Listează panelurile](https://docs.anivahealth.com/ro/api/panels/list-panels.md).

**Câmpurile panelului asociat**

**panel\_id** `string`

UUID-ul panelului — corelează cu [Listează paneluri](https://docs.anivahealth.com/ro/api/panels/list-panels.md).

**added\_at** `string`

Timestamp ISO 8601 al primei asocieri a panelului cu această programare.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

Biomarkeri à la carte asociați cu această programare în afara unui panel (vezi [Adaugă biomarkeri
personalizați](https://docs.anivahealth.com/ro/api/appointments/add-individual-biomarkers.md)). Corelează fiecare `biomarker_id`
cu [Listează biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) pentru datele de afișare.

**Câmpurile biomarkerului individual**

**biomarker\_id** `integer`

Identificatorul biomarkerului — corelează cu
[Listează biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

Timestamp ISO 8601 al primei asocieri a biomarkerului cu această programare.

**shipments** `AppointmentShipmentLink[]` *required*

Expedierile asociate acestei programări, începând cu cea mai veche asociere. Array gol când nu există expedieri
asociate. Verifică fiecare `id` prin [Obține expedierea](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md) pentru
datele complete ale expedierii (status, număr de urmărire, actualizări de status etc.).

**Câmpurile expedierii asociate**

**id** `string`

Identificatorul de referință al expedierii — corelează cu
[Obține expediere](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md).

**added\_at** `string`

Timestamp ISO 8601 al primei asocieri a expedierii cu această programare.

**lab\_codes** `string[]` *required*

Codurile de laborator (codurile de bare de pe eprubete) înregistrate pentru această programare, în
ordinea scanării. Gol până la confirmarea recoltării de sânge. O recoltare venoasă are un singur
cod tipărit pe fiecare eprubetă; o recoltare capilară are câte un cod per microtainer. Rezultatele
și documentele din [Obține rezultate](https://docs.anivahealth.com/ro/api/appointments/get-results.md) fac referire la aceste coduri
prin `lab_code`.

## Apeluri repetate

Aniva stochează răspunsul acestui endpoint timp de 5 minute pentru fiecare cheie API. Un apel repetat în
acest interval primește răspunsul stocat. Antetele `Cache-Status` și `Age` arată că răspunsul este
stocat și cât de vechi este.

Pentru a afla imediat despre o modificare, abonează-te la evenimentele webhook `appointment.created`, `appointment.rescheduled` și la evenimentul fiecărui status, de exemplu `appointment.confirmed`.
Vezi [Citiri repetate](https://docs.anivahealth.com/ro/concepts/webhooks.md#citiri-repetate).

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Parametru de interogare nevalid, de exemplu un `date` care nu este `YYYY-MM-DD`. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune sau profilul ori locația solicitată este în afara domeniului tău de permisiuni. |
| `500` | Eroare internă de server. |

```bash cURL (all appointments) theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY'
```

```bash cURL (one day at one location) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/appointments?date=2026-10-21&location_id=b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b' \
  --header 'x-api-key: YOUR_API_KEY'
```

```bash cURL (by profile) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/appointments?profile_id=a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
[
  {
    "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T10:30:00Z",
    "status": "confirmed",
    "cancellation_reason": null,
    "results_ready_emails": [],
    "draw_method": "venous",
    "created_at": "2026-04-01T09:45:00Z",
    "updated_at": null,
    "profile": {
      "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
      "handle": null,
      "first_name": "Maria",
      "last_name": "Schmidt",
      "email": "maria.schmidt@example.com",
      "phone": "+4930123456789",
      "sex": 2,
      "date_of_birth": "1985-03-22",
      "height": 168,
      "weight": 65,
      "language": "de",
      "transactional_emails_enabled": true,
      "created_at": "2026-04-01T09:14:32Z",
      "updated_at": null
    },
    "panels": [
      {
        "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "added_at": "2026-04-01T09:50:00Z"
      }
    ],
    "individual_biomarkers": [
      {
        "biomarker_id": 42,
        "added_at": "2026-04-01T09:52:00Z"
      }
    ],
    "shipments": [
      {
        "id": "P2611194821",
        "added_at": "2026-04-15T07:00:00Z"
      }
    ],
    "lab_codes": []
  }
]
```

```json 403 theme={null}
{
  "error": "Access denied: profile is outside your permission scope"
}
```


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