Java client for the Harvest API
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 11 commits ahead of dmmikkel:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

HarvestClient 2.0

This is a fork from dmmikkel's harvest client. In contrast this uses the Harvest JSON api (using Jax RS and Jackson/Jersey now) vs XML and also won't run into issues with empty datasets being returned from your queries to harvest. It also does away with the xxxCollection types that wrapped lists. Now, you just deal with Java collections!

Please note that 2.0 uses Java 8!

HarvestClient is an easy to use wrapper for the Harvest API.

It can currently only be used to fetch data from Harvest, but will eventually support creating and updating data as well.


Example that fetches all users:

HarvestClientFactory factory = new HarvestClientFactory();
HarvestClient client = factory.create("subdomain", "username", "password");
List<User> users = client.getUsers();

for (User user : users)
    // Do something

subdomain is the subdomain of your harvest account (e.g.



Gets all users.

getUsers(Date updatedSince)

Gets all users updated since updatedSince.

getUser(int id)

Gets a user by id.


Gets all clients.

getClients(Date updatedSince)

Gets all clients updated since updatedSince.

getClient(int id)

Gets a client by id.

getDayEntriesByUser(GetDayEntriesByUserParameters params)

Gets all day entries by a user.

Filters available in params.

getDayEntriesByProject(GetDayEntriesByProjectParameters params)

Gets all day entries by a project.

Filters available in params.


Gets all projects.

getProjects(Date updatedSince)

Gets all projects updated since updatedSince.

getProjects(int clientId)

Gets all projects for a client

getProjects(int clientId, Date updatedSince)

Gets all projects for a client updated since updatedSince.

getProject(int id)

Gets a project by id.


Gets all tasks.

getTasks(Date updatedSince)

Gets all tasks updated since updatedSince.

getTask(int id)

Gets a task by id.

getUserAssignments(int projectId)

Gets all user assignments for a project.

getUserAssignments(int projectId, Date updatedSince)

Gets all user assignments for a project updated since updatedSince.

getTaskAssignments(int projectId)

Gets all task assignments for a project.

getTaskAssignments(int projectId, Date updatedSince)

Gets all task assignments for a project updated since updatedSince.

getRecentInvoices(GetRecentInvoicesParameters params)

Gets the 50 most recent invoices.

Pagination and filters available in params.

getInvoice(int id)

Gets an invoice by id.


Gets all invoice item categories.

getInvoiceMessages(int invoiceId)

Gets all invoice messages for an invoice.

getInvoiceMessage(int invoiceId, int id)

Gets an invoice message.

getInvoicePayments(int invoiceId)

Gets all invoice payments for an invoice.

getInvoicePayment(int invoiceId, int id)

Gets an invoice payment for an invoice.


Any client method can throw a HarvestClientException.


Will be thrown if a required parameter is missing.


Will be thrown if the Harvest API throttle is reached.

If you encounter this you should consider caching.


  • Simplify API usage.
  • Fix issue with @JsonRootName annotation
  • Update data!