{"_id":"570c0604e5f8280e006b19a7","project":"5646482fa74cd10d00a3f014","__v":0,"initVersion":{"_id":"5646482fa74cd10d00a3f017","version":"1.2016-01-01"},"user":{"_id":"55e87bcdc5bccb2d008a9ba4","username":"","name":"Selma Pittman"},"createdAt":"2015-12-06T17:34:00.000Z","changelog":[],"body":"**###Change Date 4/11/2016**\nValidic Version 2016-03-01 is now live. Below is a list of changed functionality.\n\n**Expanded Format Change**\nPreviously when expanded was returned, those values were added to the standard response and, in some cases, overwrote the standard payload results. In Validic Version 2016-03-01, those values are returned as a key within the standard response. The following example outlines the change.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{  \\n   \\\"summary\\\":{  \\n      \\\"status\\\":200,\\n      \\\"message\\\":\\\"Ok\\\",\\n      \\\"results\\\":11813,\\n      \\\"start_date\\\":\\\"2015-10-01T08:44:29+00:00\\\",\\n      \\\"end_date\\\":\\\"2015-12-03T08:54:27+00:00\\\",\\n      \\\"offset\\\":0,\\n      \\\"limit\\\":2,\\n      \\\"previous\\\":null,\\n      \\\"next\\\":\\\"https://api.validic.com/v1/organizations/51bb1f2c6SAMPLE01a000001/nutrition/latest?access_token=9222c83bac9ded898c77bSAMPLE40afd4bb247c0e0b01SAMPLEbd8a8f544904e&end_date=2015-12-03T08%3A54%3A27Z&expanded=1&limit=2&page=2&start_date=2015-10-01T08%3A44%3A29Z\\\",\\n      \\\"params\\\":{  \\n         \\\"start_date\\\":\\\"2015-10-01T08:44:29+00:00\\\",\\n         \\\"end_date\\\":\\\"2015-12-03T08:54:27+00:00\\\",\\n         \\\"expanded\\\":true,\\n         \\\"offset\\\":0,\\n         \\\"limit\\\":2\\n      }\\n   },\\n   \\\"nutrition\\\":[  \\n      {  \\n         \\\"_id\\\":\\\"5660012868SAMPLEce066f39\\\",\\n         \\\"access_level\\\":\\\"PRIVATE\\\",\\n         \\\"activity_id\\\":\\\"5699887240\\\",\\n         \\\"amount\\\":1,\\n         \\\"brand\\\":\\\"Lose It!\\\",\\n         \\\"calories\\\":567.0,\\n         \\\"carbohydrates\\\":44.7,\\n         \\\"carbs\\\":44.7,\\n         \\\"fat\\\":30.7,\\n         \\\"fiber\\\":4.7,\\n         \\\"food_id\\\":0,\\n         \\\"is_favorite\\\":false,\\n         \\\"last_updated\\\":\\\"2015-12-03T08:45:28+00:00\\\",\\n         \\\"locale\\\":null,\\n         \\\"log_date\\\":\\\"2015-12-01\\\",\\n         \\\"log_id\\\":\\\"5699887240\\\",\\n         \\\"meal\\\":\\\"Burrito\\\",\\n         \\\"meal_type_id\\\":5,\\n         \\\"name\\\":\\\"Burrito\\\",\\n         \\\"protein\\\":32.7,\\n         \\\"sodium\\\":1507.4,\\n         \\\"source\\\":\\\"fitbit\\\",\\n         \\\"source_name\\\":\\\"Fitbit\\\",\\n         \\\"timestamp\\\":\\\"2015-12-01T08:00:00+00:00\\\",\\n         \\\"user_id\\\":\\\"53bb087184SAMPLE6a000013\\\",\\n         \\\"utc_offset\\\":\\\"-08:00\\\",\\n         \\\"validated\\\":false,\\n         \\\"water\\\":null\\n      },\\n      {  \\n         \\\"_id\\\":\\\"56600127SAMPLE7fe00616fe\\\",\\n         \\\"access_level\\\":\\\"PRIVATE\\\",\\n         \\\"activity_id\\\":\\\"5699825649\\\",\\n         \\\"amount\\\":1,\\n         \\\"brand\\\":\\\"Lose It!\\\",\\n         \\\"calories\\\":500.0,\\n         \\\"carbohydrates\\\":102.5,\\n         \\\"carbs\\\":102.5,\\n         \\\"fat\\\":2.5,\\n         \\\"fiber\\\":5.0,\\n         \\\"food_id\\\":0,\\n         \\\"is_favorite\\\":false,\\n         \\\"last_updated\\\":\\\"2015-12-03T08:45:27+00:00\\\",\\n         \\\"locale\\\":null,\\n         \\\"log_date\\\":\\\"2015-12-01\\\",\\n         \\\"log_id\\\":\\\"5699825649\\\",\\n         \\\"meal\\\":\\\"Pasta\\\",\\n         \\\"meal_type_id\\\":3,\\n         \\\"name\\\":\\\"Pasta\\\",\\n         \\\"protein\\\":17.5,\\n         \\\"sodium\\\":0.0,\\n         \\\"source\\\":\\\"fitbit\\\",\\n         \\\"source_name\\\":\\\"Fitbit\\\",\\n         \\\"timestamp\\\":\\\"2015-12-01T08:00:00+00:00\\\",\\n         \\\"user_id\\\":\\\"53bb08718SAMPLE2d6a000013\\\",\\n         \\\"utc_offset\\\":\\\"-08:00\\\",\\n         \\\"validated\\\":false,\\n         \\\"water\\\":null\\n      }\\n   ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"v1.2016-01-01\"\n    }\n  ]\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{  \\n   \\\"summary\\\":{  \\n      \\\"status\\\":200,\\n      \\\"message\\\":\\\"Ok\\\",\\n      \\\"results\\\":11813,\\n      \\\"start_date\\\":\\\"2015-10-01T08:44:29+00:00\\\",\\n      \\\"end_date\\\":\\\"2015-12-03T08:54:27+00:00\\\",\\n      \\\"offset\\\":0,\\n      \\\"limit\\\":2,\\n      \\\"previous\\\":null,\\n      \\\"next\\\":\\\"https://api.validic.com/v1/organizations/51bb1f2c6deSAMPLE000001/nutrition/latest?access_token=9222cSAMPLE9ded898c77b17SAMPLE0afd4bb247c0e0b01SAMPLEd8a8f544904e&end_date=2015-12-03T08%3A54%3A27Z&expanded=1&limit=2&page=2&start_date=2015-10-01T08%3A44%3A29Z\\\",\\n      \\\"params\\\":{  \\n         \\\"start_date\\\":\\\"2015-10-01T08:44:29+00:00\\\",\\n         \\\"end_date\\\":\\\"2015-12-03T08:54:27+00:00\\\",\\n         \\\"expanded\\\":true,\\n         \\\"offset\\\":0,\\n         \\\"limit\\\":2\\n      }\\n   },\\n   \\\"nutrition\\\":[  \\n      {  \\n         \\\"_id\\\":\\\"5660012868d48SAMPLE66f39\\\",\\n         \\\"activity_id\\\":\\\"5699887240\\\",\\n         \\\"calories\\\":567.0,\\n         \\\"carbohydrates\\\":44.7,\\n         \\\"expanded\\\":{  \\n            \\\"access_level\\\":\\\"PRIVATE\\\",\\n            \\\"amount\\\":1,\\n            \\\"brand\\\":\\\"Lose It!\\\",\\n            \\\"carbs\\\":44.7,\\n            \\\"food_id\\\":0,\\n            \\\"is_favorite\\\":false,\\n            \\\"locale\\\":null,\\n            \\\"log_date\\\":\\\"2015-12-01\\\",\\n            \\\"log_id\\\":\\\"5699887240\\\",\\n            \\\"meal_type_id\\\":5,\\n            \\\"name\\\":\\\"Burrito\\\"\\n         },\\n         \\\"fat\\\":30.7,\\n         \\\"fiber\\\":4.7,\\n         \\\"last_updated\\\":\\\"2015-12-03T08:45:28+00:00\\\",\\n         \\\"meal\\\":\\\"Burrito\\\",\\n         \\\"protein\\\":32.7,\\n         \\\"sodium\\\":1507.4,\\n         \\\"source\\\":\\\"fitbit\\\",\\n         \\\"source_name\\\":\\\"Fitbit\\\",\\n         \\\"timestamp\\\":\\\"2015-12-01T08:00:00+00:00\\\",\\n         \\\"user_id\\\":\\\"53bb0871846SAMPLE000013\\\",\\n         \\\"utc_offset\\\":\\\"-08:00\\\",\\n         \\\"validated\\\":false,\\n         \\\"water\\\":null\\n      },\\n      {  \\n         \\\"_id\\\":\\\"56600127ab5SAMPLE616fe\\\",\\n         \\\"activity_id\\\":\\\"5699825649\\\",\\n         \\\"calories\\\":500.0,\\n         \\\"carbohydrates\\\":102.5,\\n         \\\"expanded\\\":{  \\n            \\\"access_level\\\":\\\"PRIVATE\\\",\\n            \\\"amount\\\":1,\\n            \\\"brand\\\":\\\"Lose It!\\\",\\n            \\\"carbs\\\":102.5,\\n            \\\"food_id\\\":0,\\n            \\\"is_favorite\\\":false,\\n            \\\"locale\\\":null,\\n            \\\"log_date\\\":\\\"2015-12-01\\\",\\n            \\\"log_id\\\":\\\"5699825649\\\",\\n            \\\"meal_type_id\\\":3,\\n            \\\"name\\\":\\\"Pasta\\\"\\n         },\\n         \\\"fat\\\":2.5,\\n         \\\"fiber\\\":5.0,\\n         \\\"last_updated\\\":\\\"2015-12-03T08:45:27+00:00\\\",\\n         \\\"meal\\\":\\\"Pasta\\\",\\n         \\\"protein\\\":17.5,\\n         \\\"sodium\\\":0.0,\\n         \\\"source\\\":\\\"fitbit\\\",\\n         \\\"source_name\\\":\\\"Fitbit\\\",\\n         \\\"timestamp\\\":\\\"2015-12-01T08:00:00+00:00\\\",\\n         \\\"user_id\\\":\\\"53bb08718462SAMPLE000013\\\",\\n         \\\"utc_offset\\\":\\\"-08:00\\\",\\n         \\\"validated\\\":false,\\n         \\\"water\\\":null\\n      }\\n   ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"v1.2016-03-01\"\n    }\n  ]\n}\n[/block]\n\n\n**###Change Date 3/28/2016**\nReleased an update to the apps.json API call, which powers [custom marketplaces](https://docs.validic.com/docs/custom-marketplace).  These enhancements are fully backwards-compatible and therefore should not interrupt your service.  The specific additions and sort order changes are outlined below:\n* In the standard response, applications will now show two new properties: \n  * \"validated_data_available\" which indicates if the application provides validated data \n  * \"validated_object_types\" provides the data objects which can be validated\n* In the expanded response the property “supported_activity_types” which displays the supported activities for this device. These values are based on the devices marketing material. At this time, only devices which return a “fitness” record are supported. Additional devices will be supported in time. \n* The sort order is now alphabetical \n  \nAt this time, Validic is also formally releasing our [API versioning policy](https://docs.validic.com/docs/managing-change). Please take a moment to review this and understand what impact it may have on your future development planning efforts.\n\n###Change Date 1/6/2015\n**Version: '2016-01-01'**\nAdded \"relationship_to_meal\" to the response for the Diabetes object. This field indicates when the reading was taken in relation to food consumption. \nPossible Values:\n* before: reading was taken before a meal was consumed\n* after: reading was taken after a meal was consumed\n* random: reading was taken at a \"random\" time in relation to a meal, meaning not immediately before or after eating.\n* fasting: reading was taken during a fasting period\n* null: no relationship to meal value was provided\n\n\n**###Change Date 12/8/2015**\n**Version: '2016-01-01'**\n**Summary**\nExpanded data is now available without defining the source. Added new fields, various performance improvements. \n**Test URI**: https://labs.validic.com/v1/ \n\n###Change Log\n**Expanded Without Source**\nAPI requests for expanded data no longer require a source field. While you can still name a source, it is not required. \n*Impact*: Currently, users requesting expanded data without identifying a source are receiving standard data only. As of 12/8/2015, those requests will return standard and expanded data. This may increase the response time of your requests since you will receive more data. \n\n**Historical Expanded Data**\nDue to the process required to supply expanded data without source, we cannot provide historical expanded data before November 1st, 2015.  Going forward, requests for expanded data collected before November 1st will return the standard object. If you need expanded data created before this date, please contact our support team.\n\n**Date Format**\n We recently detected an issue which allowed incorrect date formats to be presented in a request. Dates are once again restricted to ISO8601 formats. We'll request that users present dates in the following formats: \n  * YYYY-MM-DDThh:mm:ss-hh:mm or YYYY-MM-DDThh:mm:ssZ \n\n**Fields Added to Response**\nThe following fields have been added:\n  * “water” appears as default field for Routine \n  * \"activity_category\" added to Fitness\n  * “validated” appears as default field. Customers using the validated flag do not need to make any changes, we will just ignore the flag. \n\n**New Documentation**\nWe have overhauled all API documentation​ to include:\n  * Updated code samples\n  * Updated design\n  * New Getting Started Guide\n  * Honestly, it's almost all new- we hope you enjoy, but understand change is hard. \n\nIf you have questions or need assistance, please contact our support team at [support@validic.com](mailto:support@validic.com).","slug":"change-log-2","title":"Change Log"}

Change Log


**###Change Date 4/11/2016** Validic Version 2016-03-01 is now live. Below is a list of changed functionality. **Expanded Format Change** Previously when expanded was returned, those values were added to the standard response and, in some cases, overwrote the standard payload results. In Validic Version 2016-03-01, those values are returned as a key within the standard response. The following example outlines the change. [block:code] { "codes": [ { "code": "{ \n \"summary\":{ \n \"status\":200,\n \"message\":\"Ok\",\n \"results\":11813,\n \"start_date\":\"2015-10-01T08:44:29+00:00\",\n \"end_date\":\"2015-12-03T08:54:27+00:00\",\n \"offset\":0,\n \"limit\":2,\n \"previous\":null,\n \"next\":\"https://api.validic.com/v1/organizations/51bb1f2c6SAMPLE01a000001/nutrition/latest?access_token=9222c83bac9ded898c77bSAMPLE40afd4bb247c0e0b01SAMPLEbd8a8f544904e&end_date=2015-12-03T08%3A54%3A27Z&expanded=1&limit=2&page=2&start_date=2015-10-01T08%3A44%3A29Z\",\n \"params\":{ \n \"start_date\":\"2015-10-01T08:44:29+00:00\",\n \"end_date\":\"2015-12-03T08:54:27+00:00\",\n \"expanded\":true,\n \"offset\":0,\n \"limit\":2\n }\n },\n \"nutrition\":[ \n { \n \"_id\":\"5660012868SAMPLEce066f39\",\n \"access_level\":\"PRIVATE\",\n \"activity_id\":\"5699887240\",\n \"amount\":1,\n \"brand\":\"Lose It!\",\n \"calories\":567.0,\n \"carbohydrates\":44.7,\n \"carbs\":44.7,\n \"fat\":30.7,\n \"fiber\":4.7,\n \"food_id\":0,\n \"is_favorite\":false,\n \"last_updated\":\"2015-12-03T08:45:28+00:00\",\n \"locale\":null,\n \"log_date\":\"2015-12-01\",\n \"log_id\":\"5699887240\",\n \"meal\":\"Burrito\",\n \"meal_type_id\":5,\n \"name\":\"Burrito\",\n \"protein\":32.7,\n \"sodium\":1507.4,\n \"source\":\"fitbit\",\n \"source_name\":\"Fitbit\",\n \"timestamp\":\"2015-12-01T08:00:00+00:00\",\n \"user_id\":\"53bb087184SAMPLE6a000013\",\n \"utc_offset\":\"-08:00\",\n \"validated\":false,\n \"water\":null\n },\n { \n \"_id\":\"56600127SAMPLE7fe00616fe\",\n \"access_level\":\"PRIVATE\",\n \"activity_id\":\"5699825649\",\n \"amount\":1,\n \"brand\":\"Lose It!\",\n \"calories\":500.0,\n \"carbohydrates\":102.5,\n \"carbs\":102.5,\n \"fat\":2.5,\n \"fiber\":5.0,\n \"food_id\":0,\n \"is_favorite\":false,\n \"last_updated\":\"2015-12-03T08:45:27+00:00\",\n \"locale\":null,\n \"log_date\":\"2015-12-01\",\n \"log_id\":\"5699825649\",\n \"meal\":\"Pasta\",\n \"meal_type_id\":3,\n \"name\":\"Pasta\",\n \"protein\":17.5,\n \"sodium\":0.0,\n \"source\":\"fitbit\",\n \"source_name\":\"Fitbit\",\n \"timestamp\":\"2015-12-01T08:00:00+00:00\",\n \"user_id\":\"53bb08718SAMPLE2d6a000013\",\n \"utc_offset\":\"-08:00\",\n \"validated\":false,\n \"water\":null\n }\n ]\n}", "language": "json", "name": "v1.2016-01-01" } ] } [/block] [block:code] { "codes": [ { "code": "{ \n \"summary\":{ \n \"status\":200,\n \"message\":\"Ok\",\n \"results\":11813,\n \"start_date\":\"2015-10-01T08:44:29+00:00\",\n \"end_date\":\"2015-12-03T08:54:27+00:00\",\n \"offset\":0,\n \"limit\":2,\n \"previous\":null,\n \"next\":\"https://api.validic.com/v1/organizations/51bb1f2c6deSAMPLE000001/nutrition/latest?access_token=9222cSAMPLE9ded898c77b17SAMPLE0afd4bb247c0e0b01SAMPLEd8a8f544904e&end_date=2015-12-03T08%3A54%3A27Z&expanded=1&limit=2&page=2&start_date=2015-10-01T08%3A44%3A29Z\",\n \"params\":{ \n \"start_date\":\"2015-10-01T08:44:29+00:00\",\n \"end_date\":\"2015-12-03T08:54:27+00:00\",\n \"expanded\":true,\n \"offset\":0,\n \"limit\":2\n }\n },\n \"nutrition\":[ \n { \n \"_id\":\"5660012868d48SAMPLE66f39\",\n \"activity_id\":\"5699887240\",\n \"calories\":567.0,\n \"carbohydrates\":44.7,\n \"expanded\":{ \n \"access_level\":\"PRIVATE\",\n \"amount\":1,\n \"brand\":\"Lose It!\",\n \"carbs\":44.7,\n \"food_id\":0,\n \"is_favorite\":false,\n \"locale\":null,\n \"log_date\":\"2015-12-01\",\n \"log_id\":\"5699887240\",\n \"meal_type_id\":5,\n \"name\":\"Burrito\"\n },\n \"fat\":30.7,\n \"fiber\":4.7,\n \"last_updated\":\"2015-12-03T08:45:28+00:00\",\n \"meal\":\"Burrito\",\n \"protein\":32.7,\n \"sodium\":1507.4,\n \"source\":\"fitbit\",\n \"source_name\":\"Fitbit\",\n \"timestamp\":\"2015-12-01T08:00:00+00:00\",\n \"user_id\":\"53bb0871846SAMPLE000013\",\n \"utc_offset\":\"-08:00\",\n \"validated\":false,\n \"water\":null\n },\n { \n \"_id\":\"56600127ab5SAMPLE616fe\",\n \"activity_id\":\"5699825649\",\n \"calories\":500.0,\n \"carbohydrates\":102.5,\n \"expanded\":{ \n \"access_level\":\"PRIVATE\",\n \"amount\":1,\n \"brand\":\"Lose It!\",\n \"carbs\":102.5,\n \"food_id\":0,\n \"is_favorite\":false,\n \"locale\":null,\n \"log_date\":\"2015-12-01\",\n \"log_id\":\"5699825649\",\n \"meal_type_id\":3,\n \"name\":\"Pasta\"\n },\n \"fat\":2.5,\n \"fiber\":5.0,\n \"last_updated\":\"2015-12-03T08:45:27+00:00\",\n \"meal\":\"Pasta\",\n \"protein\":17.5,\n \"sodium\":0.0,\n \"source\":\"fitbit\",\n \"source_name\":\"Fitbit\",\n \"timestamp\":\"2015-12-01T08:00:00+00:00\",\n \"user_id\":\"53bb08718462SAMPLE000013\",\n \"utc_offset\":\"-08:00\",\n \"validated\":false,\n \"water\":null\n }\n ]\n}", "language": "json", "name": "v1.2016-03-01" } ] } [/block] **###Change Date 3/28/2016** Released an update to the apps.json API call, which powers [custom marketplaces](https://docs.validic.com/docs/custom-marketplace). These enhancements are fully backwards-compatible and therefore should not interrupt your service. The specific additions and sort order changes are outlined below: * In the standard response, applications will now show two new properties: * "validated_data_available" which indicates if the application provides validated data * "validated_object_types" provides the data objects which can be validated * In the expanded response the property “supported_activity_types” which displays the supported activities for this device. These values are based on the devices marketing material. At this time, only devices which return a “fitness” record are supported. Additional devices will be supported in time. * The sort order is now alphabetical At this time, Validic is also formally releasing our [API versioning policy](https://docs.validic.com/docs/managing-change). Please take a moment to review this and understand what impact it may have on your future development planning efforts. ###Change Date 1/6/2015 **Version: '2016-01-01'** Added "relationship_to_meal" to the response for the Diabetes object. This field indicates when the reading was taken in relation to food consumption. Possible Values: * before: reading was taken before a meal was consumed * after: reading was taken after a meal was consumed * random: reading was taken at a "random" time in relation to a meal, meaning not immediately before or after eating. * fasting: reading was taken during a fasting period * null: no relationship to meal value was provided **###Change Date 12/8/2015** **Version: '2016-01-01'** **Summary** Expanded data is now available without defining the source. Added new fields, various performance improvements. **Test URI**: https://labs.validic.com/v1/ ###Change Log **Expanded Without Source** API requests for expanded data no longer require a source field. While you can still name a source, it is not required. *Impact*: Currently, users requesting expanded data without identifying a source are receiving standard data only. As of 12/8/2015, those requests will return standard and expanded data. This may increase the response time of your requests since you will receive more data. **Historical Expanded Data** Due to the process required to supply expanded data without source, we cannot provide historical expanded data before November 1st, 2015. Going forward, requests for expanded data collected before November 1st will return the standard object. If you need expanded data created before this date, please contact our support team. **Date Format** We recently detected an issue which allowed incorrect date formats to be presented in a request. Dates are once again restricted to ISO8601 formats. We'll request that users present dates in the following formats: * YYYY-MM-DDThh:mm:ss-hh:mm or YYYY-MM-DDThh:mm:ssZ **Fields Added to Response** The following fields have been added: * “water” appears as default field for Routine * "activity_category" added to Fitness * “validated” appears as default field. Customers using the validated flag do not need to make any changes, we will just ignore the flag. **New Documentation** We have overhauled all API documentation​ to include: * Updated code samples * Updated design * New Getting Started Guide * Honestly, it's almost all new- we hope you enjoy, but understand change is hard. If you have questions or need assistance, please contact our support team at [support@validic.com](mailto:support@validic.com).