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

> Explorar el catálogo de paneles

Devuelve los paneles que tu clave de API puede asociar mediante [Añadir paneles](https://docs.anivahealth.com/es/api/appointments/add-panels.md).
Requiere el scope `panels_access`. El objeto `pricing` también requiere el scope `prices_view`.

> [!NOTE]
>
> Cuenta `biomarker_groups` para saber cuántos resultados devuelve una extracción de sangre. Un
> grupo enumera biomarcadores intercambiables (hs-CRP *o* CRP), y el laboratorio solo mide uno de
> ellos.

## Solicitud

### Parámetros de consulta

**rate\_card** `string`

La tarifa para `price_cents`: `retail` o un `id` de tarifa de [Obtener
tarifa](https://docs.anivahealth.com/es/api/pricing/get-rate-card.md). Por defecto usa la tarifa de tu cuenta de facturación; si no,
la de venta al público. `retail_cents` siempre usa la de venta al público.

## Respuesta

Devuelve un array de paneles.

**id** `string`

UUID del panel. Pásalo a [Añadir paneles](https://docs.anivahealth.com/es/api/appointments/add-panels.md).

**name** `string`

Nombre visible.

**description** `string | null`

Para qué sirve el panel, o `null`.

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

Todos los biomarcadores de `biomarker_groups` en una lista. Consulta [Listar
biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md).

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

Los grupos que requiere el panel. Vacío para el panel personalizado: añade sus biomarcadores con
[Añadir biomarcadores individuales](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md).

**grupo**

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

Biomarcadores intercambiables. El laboratorio mide uno de ellos.

**required** `boolean`

Siempre `true` para tu clave.

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

Quién recibe el grupo, por ejemplo `sex=2` o `age>50`, unidos con `&&` o `||`. `sex` sigue
ISO/IEC 5218 (1 masculino, 2 femenino). `null` significa todos. [Previsualizar
cita](https://docs.anivahealth.com/es/api/appointments/preview-containers.md) lo aplica a un paciente.

**pricing** `object | null`

El precio según tu tarifa y el de venta al público. Consulta [objetos de
precio](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md#objetos-de-precio). `null` cuando tu clave no tiene
`prices_view`. `price_cents` es `null` para el panel personalizado.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Consulta no válida, por ejemplo un `rate_card` desconocido. |
| `403` | Falta el scope `panels_access`. |
| `500` | Error interno del 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.