Adherence

Adherence refers to statistics that measure subject performance over the course of a study.

Get Task Completion Stats for Study

Get task completion statistics for each subject in a study. This endpoint is applicable to studies run in the remote setting, in which subjects are expected to complete activities and surveys according to a "program." A task is considered complete if it is performed at least once, regardless of the time of day.

URL

GET https://mc10cloud.com/api/v1/studies/{studyId}/program_stats

Parameters

  • studyId: Study UUID

Sample Response

The following example shows task completion statistics for three subjects, each having completed a 7-day program. The properties fromDate and toDate are inclusive.

{
"items": [
{
"fromDate": "2018-05-03",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"subjectId": "fd053720-5232-11e8-8695-028eb5a65596",
"tasksAssigned": 49,
"tasksCompleted": 25,
"toDate": "2018-05-09"
},
{
"fromDate": "2018-05-07",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"subjectId": "c06b3980-521a-11e8-a47c-028eb5a65596",
"tasksAssigned": 49,
"tasksCompleted": 28,
"toDate": "2018-05-13"
},
{
"fromDate": "2018-06-01",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"subjectId": "10b52870-5aad-11e8-9dc6-0a84ea04a300",
"tasksAssigned": 49,
"tasksCompleted": 40,
"toDate": "2018-06-07"
}
],
"size": 3
}

Get Task Completion Stats for Study by Day

Get task completion statistics for a study, aggregated by day. This endpoint is applicable to studies run in the remote setting, in which subjects are expected to complete activities and surveys according to a "program." A task is considered complete if it is performed at least once, regardless of the time of day.

URL

GET https://mc10cloud.com/api/v1/studies/{studyId}/daily_program_stats

Parameters

  • studyId: Study UUID

Sample Response

The following example shows task completion statistics for the first five days of a study.

{
"items": [
{
"date": "2018-05-07",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"tasksAssigned": 49,
"tasksCompleted": 25
},
{
"date": "2018-05-08",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"tasksAssigned": 49,
"tasksCompleted": 33
},
{
"date": "2018-05-09",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"tasksAssigned": 49,
"tasksCompleted": 31
},
{
"date": "2018-05-10",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"tasksAssigned": 49,
"tasksCompleted": 23
},
{
"date": "2018-05-11",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"tasksAssigned": 49,
"tasksCompleted": 6
}
],
"size": 5
}

Get Task Completion Stats for Subject

Get task completion statistics for a subject. This endpoint is applicable to studies run in the remote setting, in which subjects are expected to complete activities and surveys according to a "program." A task is considered complete if it is performed at least once, regardless of the time of day.

URL

GET https://mc10cloud.com/api/v1/studies/{studyId}/subjects/{subjectId}/program_stats

Parameters

  • studyId: Study UUID

  • subjectId: Subject UUID

Sample Response

The following example shows daily task completion statistics for a subject who completed a 5-day program. The properties fromDate and toDate are inclusive.

{
"items": [
{
"fromDate": "2018-05-07",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"subjectId": "aae3c200-5204-11e8-bd02-0a84ea04a300",
"tasksAssigned": 7,
"tasksCompleted": 0,
"toDate": "2018-05-07"
},
{
"fromDate": "2018-05-08",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"subjectId": "aae3c200-5204-11e8-bd02-0a84ea04a300",
"tasksAssigned": 7,
"tasksCompleted": 6,
"toDate": "2018-05-08"
},
{
"fromDate": "2018-05-09",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"subjectId": "aae3c200-5204-11e8-bd02-0a84ea04a300",
"tasksAssigned": 7,
"tasksCompleted": 3,
"toDate": "2018-05-09"
},
{
"fromDate": "2018-05-10",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"subjectId": "aae3c200-5204-11e8-bd02-0a84ea04a300",
"tasksAssigned": 7,
"tasksCompleted": 0,
"toDate": "2018-05-10"
},
{
"fromDate": "2018-05-11",
"studyId": "f7888660-4f14-11e8-a47c-028eb5a65596",
"subjectId": "aae3c200-5204-11e8-bd02-0a84ea04a300",
"tasksAssigned": 7,
"tasksCompleted": 0,
"toDate": "2018-05-11"
}
],
"size": 5
}

Get Task Completion Details for Subject

Get a list of tasks completed (or not completed) by a subject. This endpoint is applicable to studies run in the remote setting, in which subjects are expected to complete activities and surveys according to a "program." A task is considered complete if it is performed at least once, regardless of the time of day.

URL

GET https://mc10cloud.com/api/v1/studies/{studyId}/subjects/{subjectId}/program_audit

Parameters

  • studyId: Study UUID

  • subjectId: Subject UUID

Sample Response

The following example shows task completion details for a subject who completed a 2-day program. On the first day, the subject completed 1 of 2 tasks; on the second day, the subject completed all tasks. For each task, the id property refers to the associated activity or diary (survey).

"items": {
[
{
"date": "2019-06-18",
"tasks": [
{
"id": "22785730-520b-11e8-a47c-028eb5a65596",
"displayName": "Walking Test",
"type": "activity",
"completed": true
},
{
"id": "c06b3980-521a-11e8-a47c-028eb5a65596",
"displayName": "Pain Survey",
"type": "diary",
"completed": false
}
]
},
{
"date": "2019-06-19",
"tasks": [
{
"id": "5230f060-6f3c-11e8-b9a9-0a84ea04a300",
"displayName": "Walking Test",
"type": "activity",
"completed": true
},
{
"id": "7921bae0-c286-11e8-aa4f-00a304ea840a",
"displayName": "Sit/Stand Test",
"type": "activity",
"completed": true
},
]
}
],
"size": 2
}