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

# Listaa paneelit

> Selaa paneelivalikoimaa

Palauttaa paneelit, jotka API-avaimesi voi liittää päätepisteellä
[Lisää paneelit](https://docs.anivahealth.com/fi/api/appointments/add-panels.md). Vaatii `panels_access`-scopen. `pricing`-objekti
vaatii lisäksi `prices_view`-scopen.

> [!NOTE]
>
> Laske `biomarker_groups`-ryhmien määrä, niin tiedät, kuinka monta tulosta verinäytteenotto
> palauttaa. Ryhmä listaa keskenään vaihdettavia biomarkkereita (hs-CRP *tai* CRP), ja laboratorio
> mittaa niistä vain yhden.

## Pyyntö

### Kyselyparametrit

**rate\_card** `string`

Hinnasto kentälle `price_cents`: `retail` tai hinnaston `id` kutsusta [Hae
hinnasto](https://docs.anivahealth.com/fi/api/pricing/get-rate-card.md). Oletuksena laskutustilisi hinnasto, muuten
vähittäishinnasto. `retail_cents` käyttää aina vähittäishinnastoa.

## Vastaus

Palauttaa taulukon paneeleista.

**id** `string`

Paneelin UUID. Välitä se kutsulle [Lisää paneelit](https://docs.anivahealth.com/fi/api/appointments/add-panels.md).

**name** `string`

Näyttönimi.

**description** `string | null`

Mihin paneeli on tarkoitettu, tai `null`.

**biomarker\_ids** `number[]`

Kaikki `biomarker_groups`-ryhmien biomarkkerit yhdessä listassa. Katso [Listaa
biomarkkerit](https://docs.anivahealth.com/fi/api/biomarkers/list-biomarkers.md).

**biomarker\_groups** `object[]`

Ryhmät, jotka paneeli vaatii. Tyhjä mukautetulla paneelilla: lisää sen biomarkkerit kutsulla
[Lisää yksittäiset biomarkkerit](https://docs.anivahealth.com/fi/api/appointments/add-individual-biomarkers.md).

**ryhmä**

**biomarker\_ids** `number[]`

Keskenään vaihdettavat biomarkkerit. Laboratorio mittaa yhden niistä.

**required** `boolean`

Avaimellasi aina `true`.

**inclusion\_condition** `string | null`

Kuka saa ryhmän, esimerkiksi `sex=2` tai `age>50`, yhdistettynä `&&`- tai `||`-merkeillä.
`sex` noudattaa standardia ISO/IEC 5218 (1 mies, 2 nainen). `null` tarkoittaa kaikkia.
[Esikatsele ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/preview-containers.md) soveltaa sitä potilaaseen.

**pricing** `object | null`

Hinta omalla hinnastollasi ja vähittäishinnastolla. Katso
[hintaobjektit](https://docs.anivahealth.com/fi/api/biomarkers/list-biomarkers.md#hintaobjektit). `null`, jos avaimeltasi puuttuu
`prices_view`. `price_cents` on mukautetulla paneelilla `null`.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Virheellinen kysely, esimerkiksi tuntematon `rate_card`. |
| `403` | Puuttuva `panels_access`-käyttöoikeus. |
| `500` | Sisäinen palvelinvirhe. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/panels' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
[
  {
    "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
    "name": "Hormones (Female)",
    "description": "Cycle-related hormones for women, including thyroid.",
    "biomarker_ids": [42, 43, 44, 51],
    "biomarker_groups": [
      { "biomarker_ids": [42], "required": true, "inclusion_condition": null },
      { "biomarker_ids": [43, 44], "required": true, "inclusion_condition": null },
      { "biomarker_ids": [51], "required": true, "inclusion_condition": "sex=2" }
    ],
    "pricing": { "price_cents": 11900, "retail_cents": 14900 }
  },
  {
    "id": "9c1d2e3f-4a5b-4c7d-8e9f-0a1b2c3d4e5f",
    "name": "Custom",
    "description": null,
    "biomarker_ids": [],
    "biomarker_groups": [],
    "pricing": { "price_cents": null, "retail_cents": null }
  }
]
```


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