> ## 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 rezultatele de laborator

> Preia rezultatele de laborator clinice și genetice pentru o comandă de kit de testare la domiciliu

Obține rezultatele de laborator clinice și genetice pentru o comandă de kit de testare la domiciliu, împreună cu referințele de document pentru PDF-urile rapoartelor de laborator.

Fiecare biomarker comandat pentru kit apare în răspuns, astfel încât să poți urmări întreaga comandă, nu doar ce a sosit deja. Rezultatele sunt înregistrate sub codul `lab_code` al comenzii — comanda de laborator este plasată la [activare](https://docs.anivahealth.com/ro/api/home-kit-orders/activate-home-kit.md), iar laboratorul raportează markerii individual pe măsură ce sunt analizați, deci un payload parțial este normal, iar `status` la nivel principal rămâne `in_progress` până la raportul final. Citește `status` la fiecare rezultat înainte de a-i folosi `value`:

* Testele încă în așteptare apar cu statusul `planned` cât timp comanda este `in_progress`. Poți apela acest endpoint înainte de activare — fiecare marker comandat este atunci `planned`.
* Rezultatele livrate de laborator, dar care **nu** trebuie folosite clinic, apar cu statusul `fault` sau `undeliverable` și au un `status_reason` care explică motivul. Un rezultat `fault` are în continuare `value` completat — acea valoare este greșită. Nu o prezenta niciodată ca o constatare.
* Rezultatele de care Aniva sau membrul se îndoiește apar cu statusul `likely_wrong` și un `status_reason`. Valoarea nu este confirmată. Nu o afișa ca o constatare fără verificare.

Folosește [Descarcă documentul](https://docs.anivahealth.com/ro/api/documents/download-document.md) pentru a descărca rapoartele de laborator în format PDF menționate în array-ul `documents`.

Nu trebuie să faci polling pe acest endpoint. Abonează-te la [webhook-urile](https://docs.anivahealth.com/ro/concepts/webhooks.md) `home_kit_order.results.updated` sau `home_kit_order.results.completed` și apelează-l când sosește un eveniment. Polling-ul funcționează în continuare ca variantă de rezervă.

Necesită scope-ul `results_view` — rezultatele de laborator și documentele sunt întotdeauna restricționate prin acesta, la fel ca rezultatele programărilor și [Descărcare document](https://docs.anivahealth.com/ro/api/documents/download-document.md) — plus scope-ul `home_kit_orders_view` sau `home_kit_orders_manage` pentru a accesa comanda de kit în sine.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al comenzii de kit de testare la domiciliu pentru care obții rezultatele.

## Răspuns

La succes, API-ul returnează `200 OK` cu obiectul de rezultate.

**status** `string` *required*

Statusul general al rezultatelor. Una dintre valorile:

* `in_progress` — unele solicitări sunt încă la laborator.
* `completed` — fiecare solicitare s-a închis și cel puțin una a trimis un raport.
* `fault` — fiecare solicitare a eșuat fără să trimită un raport. Nu se datorează nimic.

**submissions** `object[]` *required*

Câte o intrare pentru fiecare solicitare de laborator — o recoltare de sânge care implică mai multe eprubete sau laboratoare are
mai multe. Câmpul `status` de nivel superior este `completed` odată ce fiecare intrare s-a închis și una a trimis un raport.

**obiect submission**

**lab\_code** `string`

Codul de laborator (codul de bare al eprubetei) sub care a fost înregistrată această solicitare. Poate fi `null` când laboratorul nu a înregistrat
niciunul.

**status** `string` *required*

`in_progress` cât timp laboratorul încă lucrează la ea, `completed` odată ce raportul este
final sau `fault` când solicitarea a fost respinsă ori abandonată și nu va trimite niciodată un raport —
proba este adesea mutată la un alt laborator, care înregistrează apoi propria intrare.

**clinical\_results** `object[]` *required*

Listă de rezultate ale biomarkerilor clinici.

**obiect rezultat clinic**

**id** `string`

Identificatorul rândului de rezultat de laborator (UUID). Rămâne neschimbat când laboratorul corectează acel rând, deci folosește-l pentru upsert. `null` pentru un rezultat `planned`.

**status** `string` *required*

Statusul rezultatului. Una dintre:

* `planned` — comandat, încă nereturnat de laborator. `value` este `null`.
* `received` — livrat de laborator.
* `corrected` — livrat, apoi revizuit de o persoană. `value` este valoarea corectată.
* `likely_wrong` — verificarea automată Aniva sau membrul pune la îndoială valoarea. Neconfirmat: nu o afișa drept constatare fără verificare. Vezi `status_reason`.
* `fault` — livrat, dar confirmat ca fiind greșit; **nu îl folosi în scop clinic**. `value` conține valoarea greșită. Vezi `status_reason`.
* `undeliverable` — laboratorul nu a putut produce o valoare. `value` este `null`. Vezi `status_reason`.

**status\_reason** `string` *required*

De ce rezultatul este îndoielnic sau inutilizabil. Completat pentru `likely_wrong`, `fault` și `undeliverable`, `null` pentru orice alt status.

Diferit de `comment`, care este nota proprie a laboratorului pe raport — `comment` este gol la majoritatea rezultatelor cu erori, deci tratează `status_reason` drept explicația oficială.

**lab\_code** `string`

Codul de laborator (codul de bare al eprubetei) sub care a fost înregistrat rezultatul — unul dintre codurile de laborator ale comenzii. `null` pentru un rezultat `planned` și pentru rezultatele raportate de laborator fără cod.

**biomarker\_id** `integer` *required*

Identificatorul biomarkerului.

**biomarker\_name** `string` *required*

Numele de afișare al biomarkerului.

**category** `string`

Categoria biomarkerului (de ex., Hormoni, Vitamine). Poate fi `null`.

**value** `number`

Valoarea efectivă a rezultatului (corectată dacă este disponibilă, altfel brută). Poate fi `null`.

**value\_operator** `string`

Operatorul de comparație pentru valoare: `eq` (egal cu), `lt` (mai mic decât) sau `gt` (mai mare decât). Poate fi `null`.

**unit\_id** `integer`

Identificatorul unității de măsură. Poate fi `null`.

**unit** `string`

Numele de afișare al unității de măsură. Poate fi `null`.

**reference\_range\_lab** `object`

Intervalele de referință raportate de laborator pentru **acest** rezultat, convertite la aceeași unitate ca `value`. `null` când laboratorul nu a raportat niciun interval.

O limită pe care laboratorul a lăsat-o deschisă rămâne `null`, astfel încât un interval unilateral completează doar capătul propriu — un prag superior vine ca `normal_min: null, normal_max: 50`, iar unul inferior ca `normal_min: 55, normal_max: null`. Nu interpreta o limită `null` ca zero sau nelimitată implicit; interpreteaz-o ca „laboratorul nu a stabilit o limită în acea parte”.

Fiecare rezultat include intervalul în raport cu care a fost măsurat, astfel încât un pacient ale cărui rezultate provin din mai multe recoltări de sânge sau mai multe laboratoare primește intervalul corect pentru fiecare rezultat, nu doar pe cel mai recent.

**interval de referință**

**normal\_min** `number`

Limita inferioară a intervalului normal. Poate fi `null`.

**normal\_max** `number`

Limita superioară a intervalului normal. Poate fi `null`.

**optimal\_min** `number`

Limita inferioară a intervalului optim. Poate fi `null`.

**optimal\_max** `number`

Limita superioară a intervalului optim. Poate fi `null`.

**reference\_range\_lab\_absent\_reason** `string`

De ce `reference_range_lab` este `null`. `null` când `reference_range_lab` este prezent și pentru un rezultat `planned`.

* `not_provided`: nu există niciun interval. Laboratorul nu a trimis niciunul. Afișează „Nu se aplică”.
* `lab_text_only`: laboratorul a tipărit doar text, cum ar fi o țintă, un nivel de risc sau un interval pentru o etapă de viață. Afișează `lab_reported.reference_range`.
* `not_measured`: rezultatul este `undeliverable`, deci nu există nicio valoare de comparat. Afișează `status_reason`.

**aniva\_range** `object`

Valori de comparație compilate de Aniva, pe aceeași scară ca `value`. Acestea diferă în funcție de vârstă, sex și săptămâna de sarcină. `normal_*` este intervalul general. `optimal_*` este un interval mai restrâns. Valorile au doar scop informativ. Nu reprezintă sfat medical, nu sunt un diagnostic și nu reprezintă o evaluare a rezultatului. Aniva nu setează niciun indicator față de ele. Folosește `reference_range_lab` ca standard pentru rezultat. `null` când cheia ta nu are scope-ul `aniva_ranges_view` sau când Aniva nu are valori pentru acest biomarker.

**interval de referință**

**normal\_min** `number`

Limita inferioară a intervalului normal. Poate fi `null`.

**normal\_max** `number`

Limita superioară a intervalului normal. Poate fi `null`.

**optimal\_min** `number`

Limita inferioară a intervalului optim. Poate fi `null`.

**optimal\_max** `number`

Limita superioară a intervalului mai restrâns. Poate fi `null`.

**sources** `object[]`

Surse publicate pe care Aniva le-a înregistrat pentru aceste valori. Fiecare intrare are un `title` și un `url`. `url` poate fi `null`. Lista este goală când Aniva nu a înregistrat nicio sursă.

**tested\_at** `string`

Data efectuării testului în format `YYYY-MM-DD`. Poate fi `null`.

**comment** `string`

Comentariu opțional la rezultat. Poate fi `null`.

**origin** `string`

Cine a livrat documentul din care provine această valoare, la fel ca `origin` pe document. O valoare dintr-un document încărcat provine din citirea fișierului de către Aniva, nu dintr-un raport de laborator. `null` pentru un rezultat `planned`.

**lab\_reported** `object`

Linia de raport proprie a laboratorului care a efectuat analiza, cuvânt cu cuvânt — pentru a compara acest payload cu PDF-ul laboratorului. Poate fi `null` când nu deținem o înregistrare brută pentru rezultat.

Orice alt câmp al unui rezultat este normalizat: `value` și `unit` sunt convertite la unitatea implicită a biomarkerului, iar `biomarker_name` este denumirea noastră pentru analit, nu cea a laboratorului. Câmpurile de mai jos nu sunt normalizate. Tratează-le ca referință exact așa cum au fost tipărite, iar câmpurile canonice ca verificare încrucișată a consistenței.

Numerele de aici sunt limitele proprii ale laboratorului, pe propria sa scară — `reference_range_min` și `reference_range_max` **nu** au unitatea convertită și vor diferi de `reference_range_lab` oriunde cele două scări diferă. O limită pe care laboratorul a lăsat-o deschisă rămâne `null`; nimic nu este dedus sau completat implicit.

**raportat de laborator**

**name** `string`

Numele analitului așa cum a fost tipărit de laborator. Poate fi `null`.

**code** `string`

Codul propriu al laboratorului pentru analit. Poate fi `null`.

**category** `string`

Titlul secțiunii din raport, de ex. `Klinische Chemie`. Poate fi `null`.

**value** `string`

Valoarea așa cum a fost tipărită. Este un șir de caractere, astfel încât rezultatele non-numerice rămân intacte (`<0.04`, `negativ`, `1:100`). Poate fi `null`.

**unit** `string`

Unitatea așa cum a fost tipărită, de ex. `U/l`. Poate fi `null`.

**reference\_range** `string`

Intervalul de referință așa cum a fost tipărit, inclusiv praguri unilaterale: `40 - 129`, `< 50`, `> 55`. Poate fi `null`.

**reference\_range\_min** `number`

Limita inferioară a laboratorului, neconvertită. `null` pentru un interval pe care laboratorul l-a lăsat deschis inferior.

**reference\_range\_max** `number`

Limita superioară a laboratorului, neconvertită. `null` pentru un interval pe care laboratorul l-a lăsat deschis superior.

**flag** `string`

Indicatorul de anomalie al laboratorului pentru această linie: `normal`, `high`, `low`, `critical_high`, `critical_low`, `abnormal`. Un cod pe care nu îl recunoaștem este transmis exact așa cum l-a trimis laboratorul. Poate fi `null`.

**result\_status** `string`

Statusul rezultatului din laborator: `final`, `preliminary`, `correction`, `incomplete`, `partial`, `deleted`, `cannot_be_obtained`. O valoare `preliminary` poate fi încă revizuită. Un [webhook](https://docs.anivahealth.com/ro/concepts/webhooks.md)`results.updated` ulterior îți spune când să preiei din nou datele. Poate fi `null`.

**comment** `string`

Nota proprie a laboratorului pentru această linie. Spațiile de aliniere pe coloane sunt comprimate; formularea rămâne neatinsă. Poate fi `null`.

**genetic\_results** `object[]` *required*

Listă de rezultate ale biomarkerilor genetici.

**obiect rezultat genetic**

**id** `string`

Identificatorul rândului de rezultat de laborator (UUID). Rămâne neschimbat când laboratorul corectează acel rând, deci folosește-l pentru upsert. `null` pentru un rezultat `planned`.

**status** `string` *required*

Statusul rezultatului. Una dintre:

* `planned` — comandat, încă nereturnat de laborator.
* `received` — livrat de laborator.
* `likely_wrong` — verificarea automată Aniva sau membrul pune la îndoială genotipul. Neconfirmat. Vezi `status_reason`.
* `fault` — livrat, dar confirmat ca fiind greșit; **nu îl folosi în scop clinic**. Vezi `status_reason`.
* `undeliverable` — laboratorul nu a putut produce un genotip. Vezi `status_reason`.

**status\_reason** `string` *required*

De ce rezultatul este îndoielnic sau inutilizabil. Completat pentru `likely_wrong`, `fault` și `undeliverable`, `null` pentru orice alt status.

**lab\_code** `string`

Codul de laborator (codul de bare al eprubetei) sub care a fost înregistrat rezultatul. `null` pentru un rezultat `planned` și pentru rezultatele raportate de laborator fără cod.

**biomarker\_id** `integer` *required*

Identificatorul biomarkerului (genei).

**gene** `string` *required*

Simbolul genei (de ex., APOE, MTHFR).

**genotype** `string`

Afișarea genotipului (de ex., E3/E4). Poate fi `null`.

**clinical\_significance** `string`

Semnificația clinică generală. Una dintre `pathogenic`, `likely_pathogenic`, `uncertain`, `likely_benign`, `benign`, `high_risk`, `moderate_risk`, `low_risk`, `protective`, `drug_response`, `poor_metabolizer` sau `rapid_metabolizer`. Poate fi `null`.

**risk\_description** `string`

Descrierea riscului pentru acest genotip. Poate fi `null`.

**tested\_at** `string`

Data efectuării testului în format `YYYY-MM-DD`. Poate fi `null`.

**comment** `string`

Comentariu opțional la rezultat. Poate fi `null`.

**origin** `string`

Cine a livrat documentul din care provine această valoare, la fel ca `origin` pe document. O valoare dintr-un document încărcat provine din citirea fișierului de către Aniva, nu dintr-un raport de laborator. `null` pentru un rezultat `planned`.

**variants** `object[]` *required*

Variante genetice detectate.

**obiect variantă**

**name** `string` *required*

Numele uzual al variantei (de ex., APOE E4).

**clinical\_significance** `string`

Semnificația clinică la nivel de variantă. Poate fi `null`.

**description** `string`

Descrierea variantei. Poate fi `null`.

**hgvs\_c** `string`

Notația HGVS pentru ADN-ul codant. Poate fi `null`.

**hgvs\_p** `string`

Notația HGVS pentru proteină. Poate fi `null`.

**conditions** `object[]` *required*

Afecțiuni asociate.

**obiect afecțiune**

**condition** `string` *required*

Numele afecțiunii/bolii.

**association\_description** `string`

Descrierea asocierii dintre variantă și afecțiune. Poate fi `null`.

**badge** `string`

Text scurt de etichetă pentru afișare. Poate fi `null`.

**snvs** `object[]` *required*

Variantele de un singur nucleotid care definesc această variantă.

**obiect SNV**

**rs\_id** `string` *required*

Identificator dbSNP (de ex., rs429358).

**allele** `string` *required*

Alela variantei (`A`, `C`, `G`, `T`, `del`, `ins` sau `undetermined`).

**reference\_allele** `string` *required*

Alela de referință a populației.

**hgvs\_c** `string`

Notația HGVS pentru ADN-ul codant. Poate fi `null`.

**hgvs\_p** `string`

Notația HGVS pentru proteină. Poate fi `null`.

**documents** `object[]` *required*

Documentele raportului de laborator. Folosește `GET /api/v1/documents/{id}` pentru a descărca fiecare fișier.

**obiect document**

**id** `string` *required*

Identificator de fișier (UUID). Trimite-l la [Descarcă document](https://docs.anivahealth.com/ro/api/documents/download-document.md) pentru a prelua fișierul.

**file\_name** `string` *required*

Numele fișierului. [Descarcă document](https://docs.anivahealth.com/ro/api/documents/download-document.md) trimite același nume în `Content-Disposition`. Conține o dată, titlul documentului și codul de laborator, de ex. `20260405 - Quade Befund - 7642001234.pdf`. Folosește-l doar pentru afișare. Citește codul de laborator din `lab_code`, nu din nume.

**original\_file\_name** `string` *required*

Numele fișierului exact așa cum l-a livrat sursa, de ex. `7642100312_B0012_FA_V.pdf` de la laborator sau numele ales de membru pentru o încărcare. Aniva nu îl modifică.

**origin** `string` *required*

Cine a livrat fișierul. Una dintre valorile `lab` (l-a trimis laboratorul), `member_upload` (l-a încărcat membrul), `staff_upload` (l-a încărcat echipa Aniva) sau `partner_upload` (l-ai încărcat tu cu [Încarcă document](https://docs.anivahealth.com/ro/api/documents/upload-document.md)).

**content\_type** `string` *required*

Tipul media al fișierului, de ex. `application/pdf`, `image/jpeg` sau `text/csv`. Cele mai multe rapoarte de laborator sunt PDF-uri.

**etag** `string`

Versiunea conținutului fișierului. Se schimbă ori de câte ori se schimbă octeții, așa că compar-o cu valoarea stocată de tine pentru a vedea dacă trebuie să descarci din nou. [Descarcă document](https://docs.anivahealth.com/ro/api/documents/download-document.md) o trimite între ghilimele ca antetul HTTP standard `ETag`. Poate fi `null` când fișierul stocat lipsește.

**size\_bytes** `integer`

Dimensiunea fișierului în octeți. Poate fi `null` când fișierul stocat lipsește.

**lab\_code** `string`

Codul de laborator (codul de bare al eprubetei) de care aparține raportul. Poate fi `null` când laboratorul nu a înregistrat niciunul.

## Apeluri repetate

Aniva stochează răspunsul acestui endpoint timp de 60 de minute pentru fiecare cheie API. Un apel repetat în
acest interval primește răspunsul stocat cât timp comanda de kit de testare la domiciliu și rezultatele ei rămân neschimbate. După o modificare, primești un răspuns
nou. Antetele `Cache-Status` și `Age` arată că răspunsul este
stocat și ce vechime are.

Pentru a afla imediat despre o modificare, abonează-te la evenimentele webhook `home_kit_order.results.updated`, `home_kit_order.results.completed` și `home_kit_order.results.fault`.
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 — cheii tale API îi lipsește scope-ul `results_view`, îi lipsesc atât `home_kit_orders_view`, cât și `home_kit_orders_manage`, sau comanda de kit de testare la domiciliu este în afara contextului tău de acces. |
| `404` | Comanda de kit de testare la domiciliu nu a fost găsită. |
| `500` | Eroare internă de server. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "status": "in_progress",
  "submissions": [
    {
      "lab_code": "7642001234",
      "status": "in_progress"
    }
  ],
  "clinical_results": [
    {
      "id": "e9f1a3c5-6b7d-4c2e-8a4f-1d3b5c7e9f02",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 104,
      "biomarker_name": "Vitamin D",
      "category": "Vitamins",
      "value": 38.5,
      "value_operator": "eq",
      "unit_id": 1,
      "unit": "ng/mL",
      "reference_range_lab": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": 30,
        "optimal_max": 60,
        "sources": [
          {
            "title": "Example source title",
            "url": "https://example.com/source"
          }
        ]
      },
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "Vitamin D (25-OH)",
        "code": "vitd",
        "category": "Endokrinologie",
        "value": "38.5",
        "unit": "ng/ml",
        "reference_range": "30 - 100",
        "reference_range_min": 30,
        "reference_range_max": 100,
        "flag": "normal",
        "result_status": "final",
        "comment": null
      }
    },
    {
      "id": null,
      "status": "planned",
      "status_reason": null,
      "lab_code": null,
      "biomarker_id": 79,
      "biomarker_name": "Thyroid-Stimulating Hormone (TSH)",
      "category": "Hormones",
      "value": null,
      "value_operator": null,
      "unit_id": null,
      "unit": null,
      "reference_range_lab": null,
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": null,
      "comment": null,
      "origin": null,
      "lab_reported": null
    }
  ],
  "genetic_results": [
    {
      "id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8b0d13",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 348,
      "gene": "APOE",
      "genotype": "E3/E4",
      "clinical_significance": "moderate_risk",
      "risk_description": "Carriers of one APOE E4 allele have a moderately increased risk of Alzheimer's disease.",
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "variants": [
        {
          "name": "APOE E4",
          "clinical_significance": "moderate_risk",
          "description": "The E4 allele is associated with increased Alzheimer's risk.",
          "hgvs_c": "c.388T>C",
          "hgvs_p": "p.Cys130Arg",
          "conditions": [
            {
              "condition": "Alzheimer's disease",
              "association_description": "Increased risk with one E4 allele",
              "badge": "Moderate Risk"
            }
          ],
          "snvs": [
            {
              "rs_id": "rs429358",
              "allele": "C",
              "reference_allele": "T",
              "hgvs_c": "c.388T>C",
              "hgvs_p": "p.Cys130Arg"
            }
          ]
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c",
      "file_name": "20260405 - Quade Befund - 7642001234.pdf",
      "original_file_name": "7642001234_B0012_FA_E.pdf",
      "origin": "lab",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 258341,
      "lab_code": "7642001234"
    }
  ]
}
```

```json 404 theme={null}
{
  "error": "Home kit order not found"
}
```


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