Today, we’re excited to announce the launch of a new version of the Harvest API!

Our API has a long history. It was first introduced in November 2006, with a limited set of time tracking functionality. A year later, we added support for managing clients, projects, tasks, and users. In 2009, invoicing and expenses made their API debut. But the last major update to the Harvest API was made in October 2011.

The new version we’re releasing today is faster, more consistent, and more complete than our existing API (v1), and gives us a solid foundation to expose even more functionality in the future.

What’s New in API v2?

API v2 is a JSON API that allows you to interact with your Harvest account programmatically. You can track time, log expenses, create projects, and more.

Security: Authentication is even more secure. Starting with API v2, we’re replacing Basic Authentication with Personal Access Tokens via Harvest ID. To get one, sign in to your Harvest ID account and click on the Developers link in the top navigation. From there, you can create a new personal access token to authenticate yourself! You can add or destroy these as needed, so you have finer control over your tokens.

Pagination: All collection responses will be paginated so that they’re faster to generate and deliver. You’ll have the freedom to choose how many items you’d like to receive per page. We also include links to the first, last, previous, and next page.

Consistency: Consistency was a major goal for this version. We now return more appropriate HTTP response codes and use consistently coded timezone and currency codes.

Continue reading…