Skip to main content
GET
/
metrics
/
retrieve
/
{metric_id}
Get metric details
curl --request GET \
  --url https://backend.claros.health/metrics/retrieve/{metric_id}/
{
  "id": 123,
  "name": "<string>",
  "calculation_formula": [
    "<string>"
  ],
  "patient_values_count": 123,
  "description": "<string>",
  "unit": "<string>",
  "filter_variable_id": 123,
  "low_quality_threshold": 123,
  "high_quality_threshold": 123,
  "is_ascending": true
}
This endpoint requires authentication. Include your API key in the request headers as X-API-Key.
This endpoint retrieves detailed information about a specific metric.

​
Path Parameters

​
metric_id
integer
required
ID of the metric to retrieve

​
Response Fields

​
id
integer
required
Unique identifier of the metric
​
name
string
required
Name of the metric
​
description
string
Description of what the metric measures
​
unit
string
Unit of measurement for the metric
​
calculation_formula
array
required
Array of strings representing the formula used to calculate the metric
​
filter_variable_id
integer
ID of the variable used to filter patients for this metric
​
low_quality_threshold
number
The threshold below which quality is considered low
​
high_quality_threshold
number
The threshold above which quality is considered high
​
is_ascending
boolean
Whether higher values indicate better quality
​
patient_values_count
integer
Number of patient values associated with this metric

​
Example Response

{
  "id": 1,
  "name": "Blood Pressure Control",
  "description": "Percentage of patients with controlled blood pressure",
  "unit": "%",
  "calculation_formula": [
    "count(patients where bp < 140/90) / count(patients) * 100"
  ],
  "filter_variable_id": 1,
  "low_quality_threshold": 50.0,
  "high_quality_threshold": 85.0,
  "is_ascending": true,
  "patient_values_count": 150
}

​
Error Responses

​
401
object
Authentication failed. Invalid or missing API key.
​
404
object
Metric not found. The specified metric ID does not exist.

Path Parameters

​
metric_id
integer
required

Response

Successful response

​
id
integer
required

Unique identifier of the metric

​
name
string
required

Name of the metric

​
calculation_formula
string[]
required

Array of strings representing the formula used to calculate the metric

​
patient_values_count
integer
required

Number of patients with values for this metric

​
description
string

Description of what the metric measures

​
unit
string

Unit of measurement for the metric

​
filter_variable_id
integer

ID of the variable used to filter patients for this metric

​
low_quality_threshold
number

The threshold below which quality is considered low

​
high_quality_threshold
number

The threshold above which quality is considered high

​
is_ascending
boolean

Whether higher values indicate better quality