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

# Obtén un biomarcador

> Obtén un únic biomarcador per ID

Retorna un únic biomarcador pel seu `id` numèric. Útil per resoldre els ID retornats per [Llistar panells](https://docs.anivahealth.com/ca/api/panels/list-panels.md) o per les càrregues útils de les cites en detalls complets (nom, unitat, material, categoria) sense recórrer tot el catàleg.

Serveix el mateix catàleg que [Llistar biomarcadors](https://docs.anivahealth.com/ca/api/biomarkers/list-biomarkers.md), així que envia el mateix origen. Un biomarcador arxivat retorna `404`. També ho fa un biomarcador que no pots demanar en aquest origen amb els laboratoris que la teva clau pot fer servir.

Requereix l'àmbit `panels_access`. L'objecte `pricing` també requereix l'àmbit `prices_view`.

## Paràmetres de ruta

**id** `number` *required*

Identificador del biomarcador.

## Paràmetres de consulta

L'origen té una de dues formes: un centre de proves o un kit de prova a casa. Envia'n exactament un. Cap dels dos o tots dos retorna `400`.

> [tab] Centre de proves
>
> **location\_id** `string` *required*
>
> El centre on es fa l'extracció de sang de la cita. El biomarcador retorna `404` tret que la seva comanda faci la recollida
> només en els envasos que té aquest centre.

> [tab] Kit de prova a casa
>
> **home\_kit** `boolean` *required*
>
> Defineix-lo com a `true`. El biomarcador retorna `404` tret que una comanda en un laboratori de kits de prova a casa faci la recollida només en
> els envasos que conté un kit.

**rate\_card** `string`

Substitueix la taula de tarifes que utilitza `price_cents`: `retail`, o l'`id` d'una taula de tarifes que la teva clau pugui fer servir. [Obtenir taula de tarifes](https://docs.anivahealth.com/ca/api/pricing/get-rate-card.md) retorna aquest `id`. Per defecte fa servir la taula del compte de facturació de la teva clau d'API; si no, la de venda al públic.

## Resposta

**id** `number`

Identificador estable del biomarcador.

**slug** `string`

Identificador apte per a URL.

**name** `string`

Nom visible.

**description** `string | null`

Descripció detallada, quan estigui disponible.

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

Categoria principal (p. ex., `Hormones`, `Vitamins`).

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

Categoria secundària.

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

Indica si aquest biomarcador és una mesura clínica o un marcador genètic.

**material** `string | null`

Material de mostra requerit (p. ex., `serum`, `whole_blood`).

**unit** `object | null`

Unitat de mesura per defecte. Fes servir `id` per resoldre-la amb [Llistar unitats](https://docs.anivahealth.com/ca/api/units/list-units.md) si
necessites una identitat estable tot i els canvis de nom.

**Camps de la unitat**

**id** `number`

Identificador estable de la unitat de mesura.

**title** `string`

Títol canònic de la unitat (p. ex., `nmol/L`).

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

Títol visible llegible.

**pricing** `object | null`

El que costa aquest biomarcador i com es ven — consulta els [objectes de
preu](https://docs.anivahealth.com/ca/api/biomarkers/list-biomarkers.md#objectes-de-preu). És `null` **només** quan la teva clau no té
l'àmbit `prices_view`; un biomarcador al qual Aniva no ha posat preu es retorna igualment, amb
`pricing.price_cents: null`.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — `id` no vàlid, cap origen o dos orígens, o `rate_card` desconegut o no autoritzat. |
| `403` | Prohibit — manca l'àmbit `panels_access`. |
| `404` | Biomarcador no trobat, arxivat o que no es pot demanar a l'origen. També per a un `location_id` desconegut. |
| `500` | Error intern 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.