Reports API Unveiled

Great news, fellow developers and hackers – we are now ready to reveal the much requested and greatly missed Reports API.

Now you can get the aggregated or detailed information of all the time tracked in a workspace through the API in JSON format. For all the workspace users, for a single user or for a group of users – the choice is yours as there is an extensive list of filters and flags you can use. 

More detailed information about the Reports API can be found from our Github Toggl API Documentation page.

Available Reports

The API offers three different reports, which essentially are the reports you can generate in the Toggl user interface.

  • Summary report  – aggregated data which can be grouped in three different ways (by projects, clients or users), which each provide at least three sub-groupings;
  • Detailed report – returns time entries for selected filters;
  • Weekly report – returns aggregated time or earnings (this is a premium feature) by users or projects for 7 days.

Help Us Towards a Better API

We have done our best to make the API documentation as understandable as we could, but we are sure it can be done better. So, If you have any ideas about how to make the documentation better or what kind of filters or requests we should add, just let us know on the Issues page!

May 28, 2013

Related Posts


Our Biggest Mac Release Ever: The New Toggl Desktop App Is Here

The new design for the Mac Desktop introduces a clean UI and more intuitive flow, with the support of Dark mode.


Desktop Team’s Go Loco Week Sparks New, Creative Solutions for Toggl

Go Loco Week is a great opportunity for our developers to learn and work with new technologies, design new features, and just get creative!


Toggl iOS Beta: Online & Ready to Launch

UPDATE: We’ve released our iOS app and it’s high time for you to test it out! Get it on the App Store by clicking the button below! Captain Paul’s Log (November 6, 2017): We’re almost there. We fought off the Pirates of the Crash Cove, avoided the sweet call of Mermaids of Constant Redesign and