{"id":35532,"date":"2022-11-22T16:46:18","date_gmt":"2022-11-22T16:46:18","guid":{"rendered":"https:\/\/toggl.com\/blog\/?p=35532"},"modified":"2024-06-12T06:31:02","modified_gmt":"2024-06-12T06:31:02","slug":"toggl-track-reports-api-v3","status":"publish","type":"post","link":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3","title":{"rendered":"Announcing the new Toggl Track Reports API, v3"},"content":{"rendered":"\n<p>We just published user-facing documentation for the latest version of the Toggl Track Reports API \u2014 v3. Say hello to better documentation and active support.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>What\u2019s changed?<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>We now have an overview and authentication page at <a href=\"https:\/\/developers.track.toggl.com\/docs\/reports_start\" target=\"_blank\"><\/a><a href=\"https:\/\/developers.track.toggl.com\/docs\/reports_start\" target=\"_blank\">h<\/a><a href=\"https:\/\/developers.track.toggl.com\/docs\/reports_start\" target=\"_blank\" rel=\"noreferrer noopener\">ttps:\/\/developers.track.toggl.com\/docs\/reports_start<\/a>.<\/li>\n\n\n\n<li>Insights endpoints are now exposed, meaning that you can now create reports with data trends, project profitability and employee profitability from the API.<\/li>\n\n\n\n<li>The Detailed Report endpoint can group similar time entries, meaning that you can treat time entries that share the same details (date, description, task, project, client, tags, etc.) as a single time entry in your API reporting.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>What do I have to do?<\/strong><\/h2>\n\n\n\n<p>Based on user feedback we received so far, we decided to keep supporting Reports V2 for longer while we improve the new version. So, there is no deadline to migrate yet.<\/p>\n\n\n\n<p>If you decide to give V3 a try, do let us know what you think! To share your thoughts, please go to our <a href=\"https:\/\/support.toggl.com\/en\/\" target=\"_blank\">support website<\/a> and send us a message using the Live Chat bubble in the bottom-right corner.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We just published user-facing documentation for the latest version of the Toggl Track Reports API\u2014v3. Say hello to better documentation and active support.<\/p>\n","protected":false},"author":601,"featured_media":35535,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[854,992],"tags":[],"class_list":["post-35532","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-product-news","category-toggl-track"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.2 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Announcing the new Toggl Track Reports API, v3<\/title>\n<meta name=\"description\" content=\"User-facing documentation for the latest version of the Toggl Track Reports API\u2014v3. Say hello to better documentation and active support.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Announcing the new Toggl Track Reports API, v3\" \/>\n<meta property=\"og:description\" content=\"User-facing documentation for the latest version of the Toggl Track Reports API\u2014v3. Say hello to better documentation and active support.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3\" \/>\n<meta property=\"og:site_name\" content=\"Toggl Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/Toggl\/\" \/>\n<meta property=\"article:published_time\" content=\"2022-11-22T16:46:18+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-06-12T06:31:02+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"2000\" \/>\n\t<meta property=\"og:image:height\" content=\"1056\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"The Toggl Team\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@toggl\" \/>\n<meta name=\"twitter:site\" content=\"@toggl\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"The Toggl Team\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#article\",\"isPartOf\":{\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3\"},\"author\":{\"name\":\"The Toggl Team\",\"@id\":\"https:\/\/toggl.com\/blog\/#\/schema\/person\/8a9040caede2fbdfe014c9167138344c\"},\"headline\":\"Announcing the new Toggl Track Reports API, v3\",\"datePublished\":\"2022-11-22T16:46:18+00:00\",\"dateModified\":\"2024-06-12T06:31:02+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3\"},\"wordCount\":189,\"publisher\":{\"@id\":\"https:\/\/toggl.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#primaryimage\"},\"thumbnailUrl\":\"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg\",\"articleSection\":[\"Product News\",\"Toggl Track\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3\",\"url\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3\",\"name\":\"Announcing the new Toggl Track Reports API, v3\",\"isPartOf\":{\"@id\":\"https:\/\/toggl.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#primaryimage\"},\"image\":{\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#primaryimage\"},\"thumbnailUrl\":\"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg\",\"datePublished\":\"2022-11-22T16:46:18+00:00\",\"dateModified\":\"2024-06-12T06:31:02+00:00\",\"description\":\"User-facing documentation for the latest version of the Toggl Track Reports API\u2014v3. Say hello to better documentation and active support.\",\"breadcrumb\":{\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#primaryimage\",\"url\":\"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg\",\"contentUrl\":\"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg\",\"width\":2000,\"height\":1056,\"caption\":\"Repeating pattern of stylized document icons in pink against a peach background\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/toggl.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Announcing the new Toggl Track Reports API, v3\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/toggl.com\/blog\/#website\",\"url\":\"https:\/\/toggl.com\/blog\/\",\"name\":\"Toggl Blog\",\"description\":\"Everything works much better with Toggl\",\"publisher\":{\"@id\":\"https:\/\/toggl.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/toggl.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/toggl.com\/blog\/#organization\",\"name\":\"Toggl\",\"url\":\"https:\/\/toggl.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/toggl.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/10\/toggl-logo.png\",\"contentUrl\":\"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/10\/toggl-logo.png\",\"width\":814,\"height\":814,\"caption\":\"Toggl\"},\"image\":{\"@id\":\"https:\/\/toggl.com\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/Toggl\/\",\"https:\/\/x.com\/toggl\",\"https:\/\/www.instagram.com\/usetoggl\/\",\"https:\/\/www.linkedin.com\/company\/toggl\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/toggl.com\/blog\/#\/schema\/person\/8a9040caede2fbdfe014c9167138344c\",\"name\":\"The Toggl Team\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/9ad5698e745feb632df97dde968b03dd475b7153e8390d89fce9fb3f61b30b64?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/9ad5698e745feb632df97dde968b03dd475b7153e8390d89fce9fb3f61b30b64?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/9ad5698e745feb632df97dde968b03dd475b7153e8390d89fce9fb3f61b30b64?s=96&d=mm&r=g\",\"caption\":\"The Toggl Team\"},\"description\":\"Work tools to elevate your productivity \u2013 apps for incredibly simple time tracking and effective project planning.\",\"url\":\"https:\/\/toggl.com\/blog\/author\/the-toggl-team\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Announcing the new Toggl Track Reports API, v3","description":"User-facing documentation for the latest version of the Toggl Track Reports API\u2014v3. Say hello to better documentation and active support.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3","og_locale":"en_US","og_type":"article","og_title":"Announcing the new Toggl Track Reports API, v3","og_description":"User-facing documentation for the latest version of the Toggl Track Reports API\u2014v3. Say hello to better documentation and active support.","og_url":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3","og_site_name":"Toggl Blog","article_publisher":"https:\/\/www.facebook.com\/Toggl\/","article_published_time":"2022-11-22T16:46:18+00:00","article_modified_time":"2024-06-12T06:31:02+00:00","og_image":[{"width":2000,"height":1056,"url":"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg","type":"image\/jpeg"}],"author":"The Toggl Team","twitter_card":"summary_large_image","twitter_creator":"@toggl","twitter_site":"@toggl","twitter_misc":{"Written by":"The Toggl Team","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#article","isPartOf":{"@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3"},"author":{"name":"The Toggl Team","@id":"https:\/\/toggl.com\/blog\/#\/schema\/person\/8a9040caede2fbdfe014c9167138344c"},"headline":"Announcing the new Toggl Track Reports API, v3","datePublished":"2022-11-22T16:46:18+00:00","dateModified":"2024-06-12T06:31:02+00:00","mainEntityOfPage":{"@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3"},"wordCount":189,"publisher":{"@id":"https:\/\/toggl.com\/blog\/#organization"},"image":{"@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#primaryimage"},"thumbnailUrl":"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg","articleSection":["Product News","Toggl Track"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3","url":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3","name":"Announcing the new Toggl Track Reports API, v3","isPartOf":{"@id":"https:\/\/toggl.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#primaryimage"},"image":{"@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#primaryimage"},"thumbnailUrl":"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg","datePublished":"2022-11-22T16:46:18+00:00","dateModified":"2024-06-12T06:31:02+00:00","description":"User-facing documentation for the latest version of the Toggl Track Reports API\u2014v3. Say hello to better documentation and active support.","breadcrumb":{"@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#primaryimage","url":"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg","contentUrl":"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/11\/blog-api_1.jpg","width":2000,"height":1056,"caption":"Repeating pattern of stylized document icons in pink against a peach background"},{"@type":"BreadcrumbList","@id":"https:\/\/toggl.com\/blog\/toggl-track-reports-api-v3#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/toggl.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Announcing the new Toggl Track Reports API, v3"}]},{"@type":"WebSite","@id":"https:\/\/toggl.com\/blog\/#website","url":"https:\/\/toggl.com\/blog\/","name":"Toggl Blog","description":"Everything works much better with Toggl","publisher":{"@id":"https:\/\/toggl.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/toggl.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/toggl.com\/blog\/#organization","name":"Toggl","url":"https:\/\/toggl.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/toggl.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/10\/toggl-logo.png","contentUrl":"https:\/\/toggl.com\/blog\/wp-content\/uploads\/2022\/10\/toggl-logo.png","width":814,"height":814,"caption":"Toggl"},"image":{"@id":"https:\/\/toggl.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/Toggl\/","https:\/\/x.com\/toggl","https:\/\/www.instagram.com\/usetoggl\/","https:\/\/www.linkedin.com\/company\/toggl"]},{"@type":"Person","@id":"https:\/\/toggl.com\/blog\/#\/schema\/person\/8a9040caede2fbdfe014c9167138344c","name":"The Toggl Team","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/9ad5698e745feb632df97dde968b03dd475b7153e8390d89fce9fb3f61b30b64?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/9ad5698e745feb632df97dde968b03dd475b7153e8390d89fce9fb3f61b30b64?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/9ad5698e745feb632df97dde968b03dd475b7153e8390d89fce9fb3f61b30b64?s=96&d=mm&r=g","caption":"The Toggl Team"},"description":"Work tools to elevate your productivity \u2013 apps for incredibly simple time tracking and effective project planning.","url":"https:\/\/toggl.com\/blog\/author\/the-toggl-team"}]}},"_links":{"self":[{"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/posts\/35532","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/users\/601"}],"replies":[{"embeddable":true,"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/comments?post=35532"}],"version-history":[{"count":9,"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/posts\/35532\/revisions"}],"predecessor-version":[{"id":50248,"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/posts\/35532\/revisions\/50248"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/media\/35535"}],"wp:attachment":[{"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/media?parent=35532"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/categories?post=35532"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/toggl.com\/blog\/wp-json\/wp\/v2\/tags?post=35532"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}