Luna Health API / API Reference / Get a user's biomarkers Get a user's biomarkers GET /biomarkers
Retrieves a paginated list of biomarkers for a specific patient with comprehensive filtering options. Returns biomarker values, reference ranges, status classifications, and unit information. Includes metadata with statistics on biomarker status distribution.
Code samples Node.js const fetch = require('node-fetch');
async function callApi() {
const apiKey = 'YOUR_API_KEY';
const patientId = 'your-patientId';
const start_date = 'your-start_date';
const end_date = 'your-end_date';
const status = 'your-status';
const page = 'your-page';
const limit = 'your-limit';
const queryString = new URLSearchParams({
patientId: patientId,
start_date: start_date,
end_date: end_date,
status: status,
page: page,
limit: limit
}).toString();
const url = `https://account.lunahealth.app/api/biomarkers` + (queryString ? `?${queryString}` : '');
try {
const response = await fetch(url, {
method: 'GET',
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
}
});
if (!response.ok) {
throw new Error(`API error: ${response.status}`);
}
const data = await response.json();
console.log(data);
return data;
} catch (error) {
console.error('Error calling API:', error);
throw error;
}
}
callApi();Python import requests
def call_api():
api_key = 'YOUR_API_KEY'
url = 'https://account.lunahealth.app/api/biomarkers'
headers = {
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
}
params = {
'patientId': 'your-patientId',
'start_date': 'your-start_date',
'end_date': 'your-end_date',
'status': 'your-status',
'page': 'your-page',
'limit': 'your-limit'
}
try:
response = requests.get(
url,
headers=headers,
params=params
)
response.raise_for_status()
data = response.json()
print(data)
return data
except requests.exceptions.RequestException as e:
print(f'Error calling API: {e}')
raise
call_api()Parameters Name In Type Required Description patientIdquery string Yes ID of the patient to get biomarkers for start_datequery string No — end_datequery string No — statusquery string No — pagequery number No — limitquery number No —
Responses Status Description 200Successful response 400Invalid input data 401Authorization not provided 403Insufficient access 404Not found 500Internal server error
200 — Successful responseResponse fields Name Type Required Description itemsarray<object> Yes — metaobject Yes —
Example response {
"items": [
{
"id": "string",
"name": "string",
"value": 0,
"original_value": 0,
"units": "string",
"status": "ACCEPTABLE",
"reference_range": null,
"qualitative_value": "string",
"is_numeric": true,
"created_at": "string"
}
],
"meta": {
"totalCount": 0,
"currentPage": 0,
"totalPages": 0,
"status": {
"OPTIMAL": 0,
"ACCEPTABLE": 0,
"CRITICAL": 0
}
}
}400 — Invalid input dataResponse fields Name Type Required Description messagestring Yes The error message codestring Yes The error code issuesarray<object> No An array of issues that were responsible for the error
Example response {
"code": "BAD_REQUEST",
"message": "Invalid input data",
"issues": []
}401 — Authorization not providedResponse fields Name Type Required Description messagestring Yes The error message codestring Yes The error code issuesarray<object> No An array of issues that were responsible for the error
Example response {
"code": "UNAUTHORIZED",
"message": "Authorization not provided",
"issues": []
}403 — Insufficient accessResponse fields Name Type Required Description messagestring Yes The error message codestring Yes The error code issuesarray<object> No An array of issues that were responsible for the error
Example response {
"code": "FORBIDDEN",
"message": "Insufficient access",
"issues": []
}404 — Not foundResponse fields Name Type Required Description messagestring Yes The error message codestring Yes The error code issuesarray<object> No An array of issues that were responsible for the error
Example response {
"code": "NOT_FOUND",
"message": "Not found",
"issues": []
}500 — Internal server errorResponse fields Name Type Required Description messagestring Yes The error message codestring Yes The error code issuesarray<object> No An array of issues that were responsible for the error
Example response {
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}Open in interactive reference →
