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

> Iegūt asins paņemšanas pierakstu pēc ID

Iegūsti vienu asins paņemšanas pierakstu pēc tā UUID, ieskaitot iekļauto pacienta profilu. Izmanto šo galapunktu, lai pārbaudītu pieraksta statusu, apstiprinātu plānošanas informāciju vai iegūtu saistītos profila datus.

Nepieciešams `appointments_view` vai `appointments_schedule` tvērums.

## Pieprasījums

### Ceļa parametri

**id** `string` *required*

Iegūstamā pieraksta unikālais identifikators (UUID).

## Atbilde

Veiksmes gadījumā API atgriež `200 OK` ar pierakstu un tā iekļauto profilu.

**id** `string` *required*

Unikāls pieraksta identifikators (UUID).

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

Profila UUID, kuram pieder šis pieraksts.

**location\_id** `string`

Analīžu vietas UUID, kur notiek asins paņemšana.

**scheduled\_at** `string`

Ieplānotais pieraksta datums un laiks UTC formātā (ISO 8601 ar `Z` piedēkli, piem.,
`2026-05-15T10:30:00Z`). Var būt `null`.

**status** `string` *required*

Pašreizējais pieraksta statuss. Viens no: `pending`, `confirmed`, `blood_drawn` vai `cancelled`.
Detalizētu laboratorijas rezultātu gatavības informāciju var iegūt ar
[Iegūt rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md); detalizētāku sūtījuma gaitu — no katra ieraksta
iebūvētajā `shipments` masīvā (skati zemāk), tālāk izmantojot
[Iegūt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Brīva teksta iemesls, kas fiksēts pieraksta atcelšanas brīdī (piem., neierašanās, vēla atcelšana,
'Neizdevās. Nepieciešams atkārtot'). Ir `null`, ja vien `status` nav `cancelled`.

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

Adreses mazajiem burtiem, no kurām katra saņem vienu e-pastu, tiklīdz visi laboratorijas rezultāti ir galīgi. Tukšs, kad izslēgts. Skatīt
[E-pasti par gataviem rezultātiem](https://docs.anivahealth.com/lv/concepts/results.md#e-pasti-par-gataviem-rezultatiem).

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

Asins paņemšanas metode: `capillary` (no pirksta gala vai augšdelma mikrostobriņos) vai `venous` (no vēnas
stobriņos). Tā ir metode, ko nosaka pieraksts, vai arī tā [vietas](https://docs.anivahealth.com/lv/concepts/locations.md) `default_draw_method`.
Pēc asins paņemšanas tā ir izmantotā metode.

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

ISO 8601 laikspiedols, kad pieraksts tika izveidots.

**updated\_at** `string`

Pēdējā atjauninājuma ISO 8601 laikspiedols. Var būt `null`.

**profile** `object` *required*

Ar šo pierakstu saistītais pacienta profils.

**profils**

**id** `string`

Unikāls profila identifikators (UUID).

**handle** `string`

Profila segvārds vai lietotājvārds. Var būt `null`.

**first\_name** `string`

Vārds. Var būt `null`.

**last\_name** `string`

Uzvārds. Var būt `null`.

**email** `string`

E-pasta adrese. Var būt `null`.

**phone** `string`

Tālruņa numurs E.164 formātā. Var būt `null`.

**sex** `integer`

Bioloģiskais dzimums saskaņā ar ISO/IEC 5218. Var būt `null`.

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

Dzimšanas datums formātā `YYYY-MM-DD`. Var būt `null`.

**height** `number`

Augums centimetros. Var būt `null`.

**weight** `number`

Svars kilogramos. Var būt `null`.

**language** `string`

Vēlamā valoda: viens no 32 kodiem sadaļā [Izveidot profilu](https://docs.anivahealth.com/lv/api/profiles/create-profile.md).

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

Vai šis profils saņem darījumu (programmatiskos) e-pastus. Var būt `null`.

**created\_at** `string`

ISO 8601 laikspiedols, kad profils tika izveidots.

**updated\_at** `string`

Pēdējā profila atjauninājuma ISO 8601 laikspiedols. Var būt `null`.

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

Paneļi, kas pašlaik ir pievienoti šim pierakstam. Neietver atceltos pievienojumus. Skati paneļa
informāciju (nosaukumu, biomarķierus), izmantojot [Skatīt paneļus](https://docs.anivahealth.com/lv/api/panels/list-panels.md).

**Paneļa piesaistes lauki**

**panel\_id** `string`

Paneļa UUID — salīdzini ar [Paneļu saraksts](https://docs.anivahealth.com/lv/api/panels/list-panels.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad panelis pirmo reizi tika piesaistīts šim pierakstam.

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

Individuālie biomarķieri, kas piesaistīti šim pierakstam ārpus jebkura paneļa (sk. [Pievienot pielāgotus
biomarķierus](https://docs.anivahealth.com/lv/api/appointments/add-individual-biomarkers.md)). Salīdzini katru `biomarker_id`
ar [Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md), lai iegūtu attēlošanas datus.

**Individuālo biomarķieru lauki**

**biomarker\_id** `integer`

Biomarķiera identifikators — salīdzini ar
[Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad biomarķieris pirmo reizi tika piesaistīts šim pierakstam.

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

Sūtījumi, kas saistīti ar šo pierakstu, sākot ar vecāko saiti. Tukšs masīvs, ja nav saistīts
neviens sūtījums. Pārbaudi katru `id`, izmantojot [Iegūt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md), lai iegūtu
pilnus sūtījuma datus (statusu, izsekošanas numuru, statusa atjauninājumus u. c.).

**Sūtījuma saites lauki**

**id** `string`

Sūtījuma atsauces identifikators — salīdzini ar
[Iegūt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad sūtījums pirmo reizi tika piesaistīts šim pierakstam.

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

Šim pierakstam reģistrētie laboratorijas kodi (stobriņu svītrkodi) skenēšanas secībā. Tukšs, līdz asins paņemšana
ir apstiprināta. Venozai asins paņemšanai ir viens kods, kas uzdrukāts uz katra stobriņa; kapilārai asins paņemšanai ir viens
kods katram mikrostobriņam. Rezultāti un dokumenti sadaļā [Iegūt rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md) atsaucas
uz šiem kodiem ar `lab_code`.

## Atkārtoti izsaukumi

Aniva glabā šī galapunkta atbildi 15 minūtes katrai API atslēgai. Atkārtots izsaukums šajā
laikā saņem saglabāto atbildi, kamēr pieraksts nav mainījies. Pēc izmaiņām tu saņem jaunu
atbildi. Galvenes `Cache-Status` un `Age` parāda, ka atbilde ir
saglabāta un cik tā ir veca.

Lai par izmaiņām uzzinātu uzreiz, abonē webhook notikumus `appointment.created`, `appointment.rescheduled` un katra statusa notikumu, piemēram, `appointment.confirmed`.
Skati [Atkārtota lasīšana](https://docs.anivahealth.com/lv/concepts/webhooks.md#atkartota-nolasisana).

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Nederīgs ID formāts — norādītā vērtība nav derīgs UUID. |
| `403` | Aizliegts — tavai API atslēgai nav piekļuves šai darbībai. |
| `404` | Pieraksts nav atrasts. |
| `500` | Iekšēja servera kļūda. |

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