Catálogo de pruebas
Obtener biomarcador
Obtener un único biomarcador por ID
GET
/
api
/
v1
/
biomarkers
/
{id}
curl --url 'https://anivahealth.com/api/v1/biomarkers/42?home_kit=true' \
--header 'x-api-key: YOUR_API_KEY'
{
"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"
}
}
{
"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]
}
]
}
}
Devuelve un único biomarcador por su
id numérico. Es útil para resolver los ID que devuelven Listar paneles 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, 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
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, devuelve400.
- Centro de pruebas
- Kit de prueba en casa
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 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
Unidad de medida por defecto. Usa
id para consultarla en Listar unidades si
necesitas una identidad estable ante cambios de nombre.Lo que cuesta este biomarcador y cómo se vende — consulta 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. |
curl --url 'https://anivahealth.com/api/v1/biomarkers/42?home_kit=true' \
--header 'x-api-key: YOUR_API_KEY'
{
"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"
}
}
{
"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]
}
]
}
}
⌘I
curl --url 'https://anivahealth.com/api/v1/biomarkers/42?home_kit=true' \
--header 'x-api-key: YOUR_API_KEY'
{
"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"
}
}
{
"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]
}
]
}
}