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

# Listar painéis

> Explorar o catálogo de painéis

Devolve os painéis que a tua chave de API pode associar através de [Adicionar painéis](https://docs.anivahealth.com/pt/api/appointments/add-panels.md). Requer
o scope `panels_access`. O objeto `pricing` também requer o scope `prices_view`.

> [!NOTE]
>
> Conta `biomarker_groups` para saberes quantos resultados uma colheita devolve. Um grupo lista
> biomarcadores intercambiáveis (hs-CRP *ou* CRP), e o laboratório mede apenas um deles.

## Pedido

### Parâmetros de consulta

**rate\_card** `string`

O preçário para `price_cents`: `retail`, ou um `id` de preçário de [Obter
preçário](https://docs.anivahealth.com/pt/api/pricing/get-rate-card.md). Por predefinição, usa o preçário da tua conta de faturação; caso contrário, usa retalho.
`retail_cents` usa sempre retalho.

## Resposta

Devolve um array de painéis.

**id** `string`

UUID do painel. Passa-o a [Adicionar painéis](https://docs.anivahealth.com/pt/api/appointments/add-panels.md).

**name** `string`

Nome de apresentação.

**description** `string | null`

Para que serve o painel, ou `null`.

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

Todos os biomarcadores de `biomarker_groups` numa só lista. Consulta [Listar
biomarcadores](https://docs.anivahealth.com/pt/api/biomarkers/list-biomarkers.md).

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

Os grupos exigidos pelo painel. Vazio para o painel personalizado: adiciona os respetivos biomarcadores com [Adicionar
biomarcadores individuais](https://docs.anivahealth.com/pt/api/appointments/add-individual-biomarkers.md).

**grupo**

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

Biomarcadores intermutáveis. O laboratório mede um deles.

**required** `boolean`

Sempre `true` para a tua chave.

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

Quem recebe o grupo, por exemplo `sex=2` ou `age>50`, ligados com `&&` ou `||`. `sex` segue
a norma ISO/IEC 5218 (1 masculino, 2 feminino). `null` significa todos. [Pré-visualizar
marcação](https://docs.anivahealth.com/pt/api/appointments/preview-containers.md) aplica esta condição a um paciente.

**pricing** `object | null`

O preço no teu preçário e a retalho. Consulta [objetos de
preço](https://docs.anivahealth.com/pt/api/biomarkers/list-biomarkers.md#objetos-de-preco). `null` quando a tua chave não tem
`prices_view`. `price_cents` é `null` para o painel personalizado.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `400` | Query inválida, por exemplo um `rate_card` desconhecido. |
| `403` | Falta o scope `panels_access`. |
| `500` | Erro interno do servidor. |

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