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

# Obtener biomarcador

> Obtener un único biomarcador por ID

Devuelve un único biomarcador por su `id` numérico. Es útil para resolver los ID que devuelven [Listar paneles](https://docs.anivahealth.com/es/api/panels/list-panels.md) o las cargas útiles de citas en sus datos completos (nombre, unidad, material, categoría) sin recorrer todo el catálogo.

Sirve el mismo catálogo que [Listar biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md), así que envía el mismo origen. Un biomarcador archivado devuelve `404`. Lo mismo ocurre con un biomarcador que no puedes pedir en ese origen con los laboratorios que tu clave puede usar.

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

## Parámetros de ruta

**id** `number` *required*

Identificador del biomarcador.

## 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 realiza la extracción de sangre de la cita. El biomarcador devuelve `404` salvo que su pedido recoja muestras
> solo en los recipientes que tiene ese centro.

> [tab] Kit de prueba en casa
>
> **home\_kit** `boolean` *required*
>
> Establécelo en `true`. El biomarcador devuelve `404` salvo que un pedido en un laboratorio de kits de prueba en casa recoja muestras
> solo en los recipientes que incluye un kit.

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

## Respuesta

**id** `number`

Identificador estable del biomarcador.

**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](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md#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`.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Error de validación — `id` no válido, sin origen o con dos orígenes, o `rate_card` desconocido o no autorizado. |
| `403` | Prohibido — falta el alcance `panels_access`. |
| `404` | Biomarcador no encontrado, archivado o no disponible para pedir en ese origen. También un `location_id` desconocido. |
| `500` | Error interno del servidor. |

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

```json 200 theme={null}
{
  "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"
  }
}
```

```json 200 (sold only inside a position) theme={null}
{
  "id": 77,
  "slug": "mean-platelet-volume",
  "name": "Mean Platelet Volume (MPV)",
  "description": null,
  "primary_category": "Haematology",
  "secondary_category": null,
  "type": "clinical",
  "material": "whole_blood",
  "unit": { "id": 7, "title": "fL", "display_title": null },
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```


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