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

> Preia o programare pentru recoltare de sânge după ID

Obține o singură programare pentru recoltare de sânge după UUID, inclusiv profilul încorporat al pacientului. Folosește acest endpoint pentru a verifica statusul programării, a confirma detaliile programării sau a obține datele profilului asociat.

Necesită permisiunea `appointments_view` sau `appointments_schedule`.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al programării de obținut.

## Răspuns

La succes, API-ul returnează `200 OK` cu programarea și profilul ei încorporat.

**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 15 minute pentru fiecare cheie API. Un apel repetat în
acest interval primește răspunsul stocat atât timp cât programarea este neschimbată. După o modificare, primești un răspuns
nou. 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` | Format de ID invalid — valoarea furnizată nu este un UUID valid. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune. |
| `404` | Programarea nu a fost găsită. |
| `500` | Eroare internă de server. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --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 400 theme={null}
{
  "error": "Invalid appointment ID format"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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