Summary Object
Each response contains a summary object which displays important information about your request. While these fields are self-explanatory, it's important to note one significant function and that is Pagination.
Pagination
When making API calls, within a given scope, “start_date” and “end_date” (inclusive) of an API call, you may receive a large number of records. To make this easier to manage, only 100 records per page will be included in the response by default. You can receive up to a maximum of 1,000 records per page by adding a “limit” parameter.
Next URI
"next":"https://api.validic.com/v1/organizations/51adfcfd6dedSAMPLE0001/sleep/latest?access_token=b193142c7a907738ac762cbc70edd4780SAMPLE43e26232d0a3d080dSAMPLE4&end_date=2015-12-03T08%3A54%3A27Z&expanded=0&limit=200&page=2&start_date=2015-12-01T08%3A44%3A29Z",
Each response will contain a Next URI, which directs to the next page of records. Once the final page is reached, the Next URI will be null.
JSON
{
"summary":{
"status":200,
"message":"Ok",
"results":15567,
"start_date":"2015-12-01T08:44:29+00:00",
"end_date":"2015-12-03T08:54:27+00:00",
"offset":0,
"limit":200,
"previous":null, "next":"https://api.validic.com/v1/organizations/51adfcfd6dedSAMPLE00001/sleep/latest?access_token=b193142c7a907738ac762cbc70edd4780SAMPLE43e26232d0a3d080dSAMPLE4&end_date=2015-12-03T08%3A54%3A27Z&expanded=0&limit=200&page=2&start_date=2015-12-01T08%3A44%3A29Z",
"params":{
"start_date":"2015-12-01T08:44:29+00:00",
"end_date":"2015-12-03T08:54:27+00:00",
"offset":0,
"limit":200
}
},
The following table displays the Return Values found in the summary object.
Return Value | Type | Description |
---|---|---|
status | Integer | The HTTP header response code returned. |
message | String | The HTTP header response code message returned. |
results | Integer | The total number of records returned across all pages. |
start_date | String | The optional start timestamp of the activities you wish to pull in the ISO 8601 standard format”YYYY-MM-DDThh:mm:ssZ” (e.g., “2013-03-28T14:32:00+00:00″ where “+00:00″ is the UTC offset). Defaults to yesterday’s start of day (e.g., “2013-03-27T00:00:00+00:00″). May be set in GET request (e.g., &start_date=2013-03-28T14:32:00+00:00). |
end_date | String | The optional end timestamp of the activities you wish to pull in the ISO 8601 standard format”YYYY-MM-DDThh:mm:ssZ” (e.g., “2013-03-28T14:32:00+00:00″ where “+00:00″ is the UTC offset). Defaults to yesterday’s end of day (e.g., “2013-03-27T23:59:59+00:00″). May be set in GET request (e.g., &end_date=2013-03-28T14:32:00+00:00). |
offset | Integer | Record offset for retrieving paginated records. Default is 0. May be set in GET requests. |
limit | Integer | Limit of records returned per page. Default is 100. Must be an integer between 1 and 1000. May be set in GET request. |
previous | String | The URI of the previous page in the feed. |
next | String | The URI of the next page in the feed. |