Toggl API is divided into two
For changing data, including tracking time, you'll need to use the Toggl API.
If you want to get time entries of all the workspace users and aggregated data for reporting, you need to use the read-only Reports API, which gives you many options for filtering, grouping and sorting.
##The API Format##
The API accepts only JSON requests. Please make sure you're setting Content-type: application/jsonin your request header. Each request returns a JSON-encoded body.
The result of each action is communicated via standard HTTP response codes.
###Example requests###
The example requests here are done using a command line tool called cURL. If you want to try the requests out yourself, you can download cURL from here. It is available for all possible operating systems.
Under Ubuntu installing cURL is very easy:
sudo apt-get install curl##API token##
Each user in Toggl.com has an API token. They can find it under "My Profile" in their Toggl account.
##Help us towards a better API##
The Toggl API has moved to Github so you could actively participate in helping us making the API better. If you have any requests or you found a bug, you can use Github issues to let us know. You can also fork the docs and send a pull request with improvements
##Code examples##
- Benno has updated JToggl, a Java wrapper for the Toggl API to support v8: http://code.google.com/p/jtoggl/
- Mosab Ahmad has created a project using Toggl API to calculate how many hours he should work to achieve monthly goals: https://github.com/mos3abof/toggl_target
- Tom Kane has written a Ruby wrapper for Toggl API v8: https://github.com/kanet77/togglv8