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

> Explorar el catálogo de biomarcadores

Devuelve un catálogo paginado de los biomarcadores que tu clave de API puede pedir en un origen. Añádelos a [citas](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md) o a [kits de prueba en casa](https://docs.anivahealth.com/es/api/home-kit-orders/add-individual-biomarkers.md). Los biomarcadores archivados quedan excluidos.

Un biomarcador aparece en la lista cuando un pedido en un laboratorio que tu clave puede usar lo incluye y el pedido recoge muestras solo en los recipientes que tiene el origen. Lo deciden los tubos de muestra, no el tipo de analito.

Requiere el alcance `panels_access`. El objeto `pricing` también requiere el alcance `prices_view`.

## Solicitud

### Parámetros de consulta

El origen puede tener dos formas: un centro de pruebas o un kit de prueba en casa. Envía exactamente uno. Si no envías ninguno o envías ambos, devuelve `400`.

> [tab] Centro de pruebas
>
> **location\_id** `string` *required*
>
> El centro donde se realizan las extracciones de sangre de las citas. Un biomarcador aparece en la lista cuando su pedido recoge muestras solo en
> los recipientes que tiene ese centro. Relaciónalo con [Listar centros](https://docs.anivahealth.com/es/api/locations/list-locations.md).

> [tab] Kit de prueba en casa
>
> **home\_kit** `boolean` *required*
>
> Establécelo en `true`. Un biomarcador aparece en la lista cuando un pedido en un laboratorio de kits de prueba en casa recoge muestras solo en los
> recipientes que incluye un kit: suero capilar y EDTA, gota de sangre seca, orina e hisopo.
> Los biomarcadores exclusivamente venosos quedan fuera.

**rate\_card** `string`

Sobrescribe la lista de tarifas que usa `price_cents`: `retail` o el `id` de una lista de tarifas que tu clave puede usar. [Obtener lista de tarifas](https://docs.anivahealth.com/es/api/pricing/get-rate-card.md) devuelve ese `id`. Por defecto usa la lista de la cuenta de facturación de tu clave de API; si no, la de venta al público.
`retail_cents` corresponde siempre a la lista de venta al público.

**limit** `number`

Número máximo de resultados que devolver (1–1.000). Omítelo para devolver todo el catálogo coincidente — está acotado (unos
pocos miles de filas como máximo). Cuando se omite, `pagination.limit` devuelve el mismo valor que `total`.

**offset** `number` (default: 0)

Desplazamiento de paginación. Debe ser ≥ 0.

## Respuesta

**data** `Biomarker[]`

Array de biomarcadores que coinciden con la consulta.

**Campos del biomarcador**

**id** `number`

Identificador estable del biomarcador — pásalo a [Añadir biomarcadores
personalizados](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md).

**slug** `string`

Identificador apto para URL.

**name** `string`

Nombre visible.

**description** `string | null`

Descripción detallada, cuando está disponible.

**primary\_category** `string | null`

Categoría principal (p. ej., `Hormones`, `Vitamins`).

**secondary\_category** `string | null`

Categoría secundaria.

**type** `"clinical" | "genetic"`

Indica si este biomarcador es una medición clínica o un marcador genético.

**material** `string | null`

Material de muestra necesario (p. ej., `serum`, `whole_blood`).

**unit** `object | null`

Unidad de medida por defecto. Usa `id` para consultarla en [Listar unidades](https://docs.anivahealth.com/es/api/units/list-units.md)
si necesitas una identidad estable ante cambios de nombre.

**Campos de la unidad**

**id** `number`

Identificador estable de la unidad de medida.

**title** `string`

Título canónico de la unidad (p. ej., `nmol/L`).

**display\_title** `string | null`

Título legible para mostrar.

**pricing** `object | null`

Lo que cuesta este biomarcador y cómo se vende — consulta [objetos de precio](#objetos-de-precio). Es `null`
**solo** cuando tu clave no tiene el alcance `prices_view`; un biomarcador al que Aniva no le ha fijado precio se
sigue devolviendo, con `pricing.price_cents: null`.

**pagination** `object`

**Campos de paginación**

**total** `number`

Total de filas que coinciden con la consulta en todas las páginas.

**limit** `number`

Límite aplicado a esta página. Devuelve el mismo valor que `total` cuando se omitió el parámetro de consulta `limit` (se devolvió todo el
catálogo).

**offset** `number`

Desplazamiento aplicado a esta página.

**has\_more** `boolean`

`true` cuando hay más páginas disponibles.

## Objetos de precio

Los precios tienen una única estructura allá donde aparecen — biomarcadores, paneles, la
[vista previa](https://docs.anivahealth.com/es/api/appointments/preview-containers.md) de la cita y un [presupuesto](https://docs.anivahealth.com/es/api/pricing/quote-cart.md). [Precios](https://docs.anivahealth.com/es/concepts/pricing.md) explica el modelo
que hay detrás; esta es la referencia de campos.

Todos los importes están en céntimos enteros.

**price\_cents** `integer | null`

Lo que cuesta en **tu** lista de tarifas. `0` es un precio real de cero — el elemento no se vende por
separado, y el bloque `requires` o `positions` contiguo indica cómo se vende en su lugar. `null` es
distinto: Aniva no le ha fijado precio, no tiene coste cero, no se puede pedir y no suma nada a
ningún total.

**retail\_cents** `integer | null`

El mismo importe en la lista de tarifas recomendada de venta al público. Siempre presente; igual a `price_cents` cuando tu
clave ya usa la lista de venta al público.

**tier** `"routine" | "specialty"`

Cuál de las dos tarifas de Aniva de tu lista fijó el precio de este marcador. Presente solo cuando tiene precio
propio.

**positions** `object[]`

Las ofertas comerciales que contienen este biomarcador, de la más barata a la más cara. Con `price_cents: 0` son
la única forma de pedirlo; con un `price_cents` positivo son los paquetes a los que también pertenece.
Una posición se factura **una vez** y siempre se entrega completa.

**id** `string`

Identificador estable de la posición. Enlaza con `via_position` en la factura de una cita.

**name** `string`

Nombre de la posición visible para el socio.

**price\_cents** `integer | null`

Lo que cuesta toda la posición en tu tarifa, facturada una sola vez. `retail_cents` va junto a él.

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

Todos los biomarcadores que ofrece la posición, incluido el que consultaste.

**includes** `number[]`

Los demás elementos aparte del biomarcador que consultaste: lo que viene incluido al comprarlo.

**requires** `object[]`

Presente cuando este biomarcador es un **cociente**. Al pedirlo, estos componentes se añaden al
carrito con sus propios precios, y cada componente se paga una sola vez por carrito sin importar
cuántos cocientes dependan de él. El `price_cents` propio del cociente se factura además de sus
componentes. La mayoría de los cocientes cuestan `0`. Cada entrada contiene `id`, `name`,
`price_cents` y `retail_cents`.

Un cociente cuyos componentes no tengan todos precio queda fuera del catálogo por completo: nunca
aparece con `price_cents: null`.

Los paneles solo incluyen `price_cents` y `retail_cents`: un panel tiene un único precio de catálogo y
ninguna posición ni componente.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Error de validación: p. ej., sin origen o con dos orígenes, `limit` fuera de rango o `rate_card` desconocida o no autorizada. |
| `403` | Prohibido: falta el permiso `panels_access`. |
| `404` | `location_id` no corresponde a ningún centro de pruebas. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/biomarkers?home_kit=true&limit=5' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "data": [
    {
      "id": 42,
      "slug": "vitamin-d-25-oh",
      "name": "Vitamin D (25-OH)",
      "description": "Serum 25-hydroxyvitamin D …",
      "primary_category": "Vitamins",
      "secondary_category": null,
      "type": "clinical",
      "material": "serum",
      "unit": { "id": 1, "title": "nmol/L", "display_title": null },
      "pricing": {
        "price_cents": 3952,
        "retail_cents": 4549,
        "tier": "specialty",
        "positions": [
          {
            "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
            "name": "Vitamin panel",
            "price_cents": 6900,
            "retail_cents": 7935,
            "biomarker_ids": [42, 43, 44],
            "includes": [43, 44]
          }
        ]
      }
    }
  ],
  "pagination": { "total": 17, "limit": 5, "offset": 0, "has_more": true }
}
```


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