Get a list of measurements
Retrieve a list of measurements associated with a specific wound, with optional sorting, pagination, and filtering.
Query parameters
-
Number of items per page.
-
Comma-separated list of fields to be returned in the response. Only 'id', 'uid', 'type', 'avg_depth', 'max_depth', 'max_width', 'max_length', 'perimeter', 'area', 'volume', 'date', 'granulation', 'slough', 'eschar', 'is_locked', and 'images' columns are allowed.
-
Filter criteria to narrow down the list of measurements. The filter parameter is an object with key-value pairs where the key is the field to filter by and the value is '{operator}{value}'. The operator is optional and defaults to '='. (e.g. '/measurements?wound_id=3089&filter[type]=group&filter[date]=>=2021-01-01')
-
Field to sort the results by. Only 'id' and 'created_at' columns are allowed, prefixed with a minus sign (-) for descending order and without for ascending order.
Values are
id,-id,created_at, or-created_at.
curl \
--request GET 'https://publicapi.ekareinc.com/api/v1/measurements' \
--header "X-API-KEY: $API_KEY"
{
"data": [
{
"id": 134,
"uid": "4464009e4213edc92895fe0eaae067e4",
"type": "group",
"avg_depth": 0.5,
"max_depth": 0.7,
"max_width": 0.8,
"max_length": 0.9,
"perimeter": 1,
"area": 1.1,
"volume": 1.2,
"date": "2021-10-01",
"granulation": 0.3,
"slough": 0.4,
"eschar": 0.5,
"is_locked": false,
"images": {
"thumbnail": "https://publicapi.ekareinc.com/api/v1/measurements/134/images/U2FsdGVkX1+HSFDIKaBoB33VyLeJtuyO4AOHuoBtnqgA537mI2VKvh/Exh61E7cTMwajA/fbZ1fGLDOJCxgLXAwnm8KR4zy3yHaFy9yBq21jiL0iOvlGbaap6O9cAD5atuEYDx70iAk0oZnSFJrF6Q==",
"original": "https://publicapi.ekareinc.com/api/v1/measurements/134/images/U2FsdGVkX1+HSFDIKaBoB33VyLeJtuyO4AOHuoBtnqgA537mI2VKvh/Exh61E7cTMwajA/fbZ1fGLDOJCxgLXAwnm8KR4zy3yHaFy9yBq21jiL0iOvlGbaap6O9cAD5atuEYDx70iAk0oZnSFJrF6Q==",
"outline": "https://publicapi.ekareinc.com/api/v1/measurements/134/images/U2FsdGVkX1+HSFDIKaBoB33VyLeJtuyO4AOHuoBtnqgA537mI2VKvh/Exh61E7cTMwajA/fbZ1fGLDOJCxgLXAwnm8KR4zy3yHaFy9yBq21jiL0iOvlGbaap6O9cAD5atuEYDx70iAk0oZnSFJrF6Q==",
"classification": "https://publicapi.ekareinc.com/api/v1/measurements/134/images/U2FsdGVkX1+HSFDIKaBoB33VyLeJtuyO4AOHuoBtnqgA537mI2VKvh/Exh61E7cTMwajA/fbZ1fGLDOJCxgLXAwnm8KR4zy3yHaFy9yBq21jiL0iOvlGbaap6O9cAD5atuEYDx70iAk0oZnSFJrF6Q=="
},
"children": [
{
"id": 135,
"uid": "unique-id-2",
"area": 1.2,
"date": "2021-10-02",
"type": "regular",
"eschar": 0.6,
"images": {
"outline": "https://publicapi.ekareinc.com/api/v1/measurements/135/images/U2FsdGVkX1+HSFDIKaBoB33VyLeJtuyO4AOHuoBtnqgA537mI2VKvh/Exh61E7cTMwajA/fbZ1fGLDOJCxgLXAwnm8KR4zy3yHaFy9yBq21jiL0iOvlGbaap6O9cAD5atuEYDx70iAk0oZnSFJrF6Q==",
"original": "https://publicapi.ekareinc.com/api/v1/measurements/135/images/U2FsdGVkX1+HSFDIKaBoB33VyLeJtuyO4AOHuoBtnqgA537mI2VKvh/Exh61E7cTMwajA/fbZ1fGLDOJCxgLXAwnm8KR4zy3yHaFy9yBq21jiL0iOvlGbaap6O9cAD5atuEYDx70iAk0oZnSFJrF6Q==",
"classification": "https://publicapi.ekareinc.com/api/v1/measurements/135/images/U2FsdGVkX1+HSFDIKaBoB33VyLeJtuyO4AOHuoBtnqgA537mI2VKvh/Exh61E7cTMwajA/fbZ1fGLDOJCxgLXAwnm8KR4zy3yHaFy9yBq21jiL0iOvlGbaap6O9cAD5atuEYDx70iAk0oZnSFJrF6Q=="
},
"slough": 0.5,
"volume": 1.3,
"children": [],
"avg_depth": 0.6,
"is_locked": false,
"max_depth": 0.8,
"max_width": 0.9,
"perimeter": 1.1,
"max_length": 1,
"granulation": 0.4
}
],
"created_at": "2021-01-01 00:00:00"
}
],
"metadata": {
"current_page": 1,
"last_page": 55,
"per_page": 2,
"total": 110,
"next_page_url": "https://publicapi.ekareinc.com/api/v1/measurements?wound_id=3089&page=2",
"prev_page_url": "string"
}
}
{
"error": "Invalid API token",
"message": "Unauthorized. Please provide a valid API token.",
"error_code": "100"
}
{
"error": "Wound Not Found",
"message": "The wound with the specified ID was not found.",
"error_code": "111"
}
{
"error": "Access denied",
"message": "Forbidden. You do not have permission to access this resource.",
"error_code": "101"
}
{
"error": "Bad Request",
"message": "The given data was invalid.",
"error_code": "102"
}