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

# Obter biomarcador

> Obter um único biomarcador por ID

Devolve um único biomarcador pelo seu `id` numérico. Útil para resolver os IDs devolvidos por [Listar painéis](https://docs.anivahealth.com/pt/api/panels/list-panels.md) ou pelos payloads de marcações em detalhes completos (nome, unidade, material, categoria) sem percorrer todo o catálogo.

Serve o mesmo catálogo que [Listar biomarcadores](https://docs.anivahealth.com/pt/api/biomarkers/list-biomarkers.md), por isso envia a mesma origem. Um biomarcador arquivado devolve `404`. O mesmo acontece com um biomarcador que não podes pedir nessa origem com os laboratórios que a tua chave pode usar.

Requer o scope `panels_access`. O objeto `pricing` também requer o scope `prices_view`.

## Parâmetros de caminho

**id** `number` *required*

Identificador do biomarcador.

## Parâmetros de consulta

A origem tem uma de duas formas: um local de teste ou um kit de teste em casa. Envia exatamente uma. Enviar nenhuma ou ambas devolve `400`.

> [tab] Local de teste
>
> **location\_id** `string` *required*
>
> O local onde é feita a colheita da marcação. O biomarcador devolve `404`, a menos que o seu
> pedido faça a colheita apenas para os recipientes que esse local tem.

> [tab] Kit de teste em casa
>
> **home\_kit** `boolean` *required*
>
> Define como `true`. O biomarcador devolve `404`, a menos que um pedido num laboratório de kits
> de teste em casa faça a colheita apenas para os recipientes que um kit contém.

**rate\_card** `string`

Substitui a tabela de preços que `price_cents` usa: `retail`, ou o `id` de uma tabela de preços que a tua chave pode usar. [Obter tabela de preços](https://docs.anivahealth.com/pt/api/pricing/get-rate-card.md) devolve esse `id`. Por predefinição, usa a tabela da conta de faturação da tua chave de API; caso contrário, a de venda ao público.

## Resposta

**id** `number`

Identificador estável do biomarcador.

**slug** `string`

Identificador seguro para URL.

**name** `string`

Nome de apresentação.

**description** `string | null`

Descrição detalhada, quando disponível.

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

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

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

Categoria secundária.

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

Indica se este biomarcador é uma medição clínica ou um marcador genético.

**material** `string | null`

Material de amostra necessário (por ex., `serum`, `whole_blood`).

**unit** `object | null`

Unidade de medida predefinida. Usa `id` para referenciar em [Listar unidades](https://docs.anivahealth.com/pt/api/units/list-units.md) se
precisares de uma identidade estável mesmo após alterações de nome.

**Campos da unidade**

**id** `number`

Identificador estável da unidade de medida.

**title** `string`

Título canónico da unidade (por ex., `nmol/L`).

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

Título de apresentação legível.

**pricing** `object | null`

Quanto custa este biomarcador e como é vendido — consulta [objetos de
preço](https://docs.anivahealth.com/pt/api/biomarkers/list-biomarkers.md#objetos-de-preco). É `null` **apenas** quando a tua chave não tem o
scope `prices_view`; um biomarcador sem preço definido pela Aniva continua a ser devolvido, com
`pricing.price_cents: null`.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `400` | Erro de validação — `id` inválido, sem origem ou com duas origens, ou `rate_card` desconhecido/não autorizado. |
| `403` | Proibido — falta o scope `panels_access`. |
| `404` | Biomarcador não encontrado, arquivado ou que não pode ser pedido na origem. Também um `location_id` desconhecido. |
| `500` | Erro interno do 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.