The TSheets API (Application Programming Interface) is based on REST principles. It's very easy to write and test applications. You can use your browser to access URLs, and you can use pretty much any TLS-capable HTTP client in any programming language to interact with the API. The API allows you to query meta-data about your account, users, jobcodes, timesheets, GPS points, and custom fields. You can also create timesheets, users, jobcodes, etc.
All access to the API occurs over an TLS-encrypted secure channel, so your API client must support TLS. To ensure data privacy, unencrypted HTTP is not supported.
The quickest way to get started is to use our Postman request collection. The following steps will help you get up and running as quickly as possible. If you prefer, our API can also easily be explored with other tools, like curl.
All URLs referenced in the documentation have the following base:
To prevent abuse of the TSheets API, we limit requests to a maximum number (currently 300) within a given time window (currently 10 minutes). Rate limiting is primarily considered on a per-connection basis (per access token). If you exceed the current rate limit, you will receive a 429 'Too many requests' response from our API. You will continue to receive a 429 response until you're out of the current time window. The threshold and time window may adjust dynamically to lower values if you are found to be abusing the system. These thresholds are subject to change - we'll keep this page updated if/when any changes are made.
This documentation explains the format for raw HTTP(S) calls to the TSheets API. Helper libraries are also available upon request in a number of popular programming languages, which make it easy for you to get started with TSheets.
While a helper library can make it easier to consume the API, it is certainly not necessary and the API is still very straight-forward to use even without one. Simply use a built-in http class or library for your language of choice.
By default we allow you to connect to 3 additional client accounts (besides your own) via your API application keys. If you are building an integration and are interested in enabling your application for use by any TSheets customer, please fill out the form at the bottom of our partnerships page and we can help guide you through our simple integration process.
Here are a few of the things we'll be looking for before allowing your application access to our other TSheets customers:
If you encounter any problems consuming the API or have suggestions please feel free to contact us at email@example.com
Current version: 1.0
Last Updated: January 04, 2019