Skip to content
Changelog

Report a bug

Harvest integration: operations for AI agents

Harvest connects to Type.com as an integration. This page lists the 202 operations documented for Claude and Codex in Type.com: 92 read, 81 write, 29 destructive.

About Harvest

Harvest is a time-tracking and invoicing tool designed for teams and freelancers, helping them log billable hours, manage projects, and streamline payments

Categories: Productivity & Project Management

How to connect Harvest to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

202 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

202 operations listed.

Approvals

  • Read

    List all approvals

    Returns one period’s approvals, grouped by user. The response contains an object with an approvals property that contains an array of up to per_page approval objects, ordered by user name.

    GET /v2/approvals

  • Write

    Submit a timesheet for approval

    Submits a user’s timesheet for a date range, moving their time entries and expenses in that range into the submitted bucket.

    POST /v2/approvals/submit

Clients

  • Read

    List all clients

    Returns a list of your clients. The clients are returned sorted by creation date, with the most recently created clients appearing first.

    GET /v2/clients

  • Read

    Retrieve a client

    Retrieves the client with the given ID.

    GET /v2/clients/{CLIENT_ID}

  • Write

    Create a client

    Creates a new client object.

    POST /v2/clients

  • Write

    Update a client

    Updates the specific client by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/clients/{CLIENT_ID}

  • Destructive

    Delete a client

    Delete a client. Deleting a client is only possible if it has no projects, invoices, or estimates associated with it.

    DELETE /v2/clients/{CLIENT_ID}

Client Contacts

  • Read

    List all contacts

    Returns a list of your contacts. The contacts are returned sorted by creation date, with the most recently created contacts appearing first.

    GET /v2/contacts

  • Read

    Retrieve a contact

    Retrieves the contact with the given ID.

    GET /v2/contacts/{CONTACT_ID}

  • Write

    Create a contact

    Creates a new contact object.

    POST /v2/contacts

  • Write

    Update a contact

    Updates the specific contact by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/contacts/{CONTACT_ID}

  • Destructive

    Delete a contact

    Delete a contact.

    DELETE /v2/contacts/{CONTACT_ID}

Company

  • Read

    Retrieve a company

    Retrieves the company for the currently authenticated user.

    GET /v2/company

  • Read

    Retrieve reimbursement settings

    Retrieves the company’s expense reimbursement preferences.

    GET /v2/company/reimbursement_settings

  • Write

    Update a company

    Updates the company setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/company

  • Write

    Update reimbursement settings

    Updates the company’s expense reimbursement preferences. Only the parameters provided are changed; any parameter omitted keeps its value.

    PATCH /v2/company/reimbursement_settings

  • Write

    Enroll in e-invoicing

    Enrolls the company as a Peppol sender.

    POST /v2/company/e_invoicing

  • Destructive

    Disconnect from e-invoicing

    Disconnects the company’s Peppol enrollment.

    DELETE /v2/company/e_invoicing

Estimate Item Categories

  • Read

    List all estimate item categories

    Returns a list of your estimate item categories. The estimate item categories are returned sorted by creation date, with the most recently created estimate item categories appearing first.

    GET /v2/estimate_item_categories

  • Read

    Retrieve an estimate item category

    Retrieves the estimate item category with the given ID.

    GET /v2/estimate_item_categories/{ESTIMATE_ITEM_CATEGORY_ID}

  • Write

    Create an estimate item category

    Creates a new estimate item category object.

    POST /v2/estimate_item_categories

  • Write

    Update an estimate item category

    Updates the specific estimate item category by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/estimate_item_categories/{ESTIMATE_ITEM_CATEGORY_ID}

  • Destructive

    Delete an estimate item category

    Delete an estimate item category.

    DELETE /v2/estimate_item_categories/{ESTIMATE_ITEM_CATEGORY_ID}

Estimate Messages

  • Read

    List all messages for an estimate

    Returns a list of messages associated with a given estimate. The estimate messages are returned sorted by creation date, with the most recently created messages appearing first.

    GET /v2/estimates/{estimate_ID}/messages

  • Write

    Create an estimate message

    Creates a new estimate message object.

    POST /v2/estimates/{estimate_ID}/messages

  • Destructive

    Delete an estimate message

    Delete an estimate message.

    DELETE /v2/estimates/{estimate_ID}/messages/{message_ID}

Estimates

  • Read

    List all estimates

    Returns a list of your estimates. The estimates are returned sorted by issue date, with the most recently issued estimates appearing first.

    GET /v2/estimates

  • Read

    Retrieve an estimate

    Retrieves the estimate with the given ID.

    GET /v2/estimates/{ESTIMATE_ID}

  • Write

    Create an estimate

    Creates a new estimate object.

    POST /v2/estimates

  • Write

    Update an estimate

    Updates the specific estimate by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/estimates/{ESTIMATE_ID}

  • Destructive

    Delete an estimate

    Delete an estimate.

    DELETE /v2/estimates/{ESTIMATE_ID}

Expense Categories

  • Read

    List all expense categories

    Returns a list of your expense categories. The expense categories are returned sorted by creation date, with the most recently created expense categories appearing first.

    GET /v2/expense_categories

  • Read

    Retrieve an expense category

    Retrieves the expense category with the given ID.

    GET /v2/expense_categories/{EXPENSE_CATEGORY_ID}

  • Write

    Create an expense category

    Creates a new expense category object.

    POST /v2/expense_categories

  • Write

    Update an expense category

    Updates the specific expense category by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/expense_categories/{EXPENSE_CATEGORY_ID}

  • Destructive

    Delete an expense category

    Delete an expense category.

    DELETE /v2/expense_categories/{EXPENSE_CATEGORY_ID}

Expenses

  • Read

    List all expenses

    Returns a list of your expenses. If accessing this endpoint as an Administrator, all expenses in the account will be returned.

    GET /v2/expenses

  • Read

    Retrieve an expense

    Retrieves the expense with the given ID.

    GET /v2/expenses/{EXPENSE_ID}

  • Write

    Create an expense

    Creates a new expense object.

    POST /v2/expenses

  • Write

    Update an expense

    Updates the specific expense by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/expenses/{EXPENSE_ID}

  • Write

    Approve an expense

    Approves a submitted expense, with the same effect as the Approvals page’s approve action. Approval applies to the expense’s submitter, project, and spent date, so matching time entries for that member, project, and day can change state with the expense.

    POST /v2/expenses/{EXPENSE_ID}/approve

  • Write

    Withdraw an expense

    Withdraws an approved expense, returning it to submitted status, with the same effect as the Approvals page’s withdraw action. Withdrawal applies to the expense’s submitter, project, and spent date, so matching time entries for that member, project, and day can change state with the expense.

    POST /v2/expenses/{EXPENSE_ID}/withdraw

  • Destructive

    Delete an expense

    Delete an expense.

    DELETE /v2/expenses/{EXPENSE_ID}

Imports

  • Read

    List all imports

    Returns the account’s recent import runs, newest first. The listing is limited to runs created in the last 30 days.

    GET /v2/imports

  • Read

    Retrieve an import

    Retrieves the details of an existing import run.

    GET /v2/imports/{IMPORT_ID}

  • Read

    Download the CSV errors for an import

    Downloads the rows that failed to import, as a text/csv file. The response has a Content-Disposition: attachment header.

    GET /v2/imports/{IMPORT_ID}/csv_errors

  • Write

    Create an import

    The response includes a Location header with the URL of the created run.

    POST /v2/imports

  • Write

    Revert an import

    Undoes a finished import by deleting the records it created.

    POST /v2/imports/{IMPORT_ID}/revert

Gusto Settings and User Mappings

  • Read

    Retrieve Gusto settings

    Returns the account’s Gusto settings object and a 200 OK response code.

    GET /v2/integrations/gusto/settings

  • Write

    Update Gusto settings

    Updates the FLSA workweek anchor and the sync-reminder schedule.

    PATCH /v2/integrations/gusto/settings

  • Write

    Create a user mapping

    Links a teammate to a Gusto person.

    POST /v2/integrations/gusto/user_mappings

  • Write

    Bulk create user mappings

    Links several teammates to Gusto people in one request.

    POST /v2/integrations/gusto/user_mappings/bulk_create

  • Destructive

    Delete a user mapping

    Unlinks a teammate from their Gusto person.

    DELETE /v2/integrations/gusto/user_mappings/{USER_MAPPING_ID}

Gusto Sync Runs

  • Read

    Retrieve a sync run

    Retrieves an existing sync run.

    GET /v2/integrations/gusto/sync_runs/{SYNC_RUN_ID}

  • Write

    Preview a sync run

    Previews a time-sheet sync for a date range or a Gusto payroll.

    POST /v2/integrations/gusto/sync_runs/preview

  • Write

    Create a sync run

    Creates and queues a time-sheet sync run for a date range or a Gusto payroll.

    POST /v2/integrations/gusto/sync_runs

Invoice Item Categories

  • Read

    List all invoice item categories

    Returns a list of your invoice item categories. The invoice item categories are returned sorted by creation date, with the most recently created invoice item categories appearing first.

    GET /v2/invoice_item_categories

  • Read

    Retrieve an invoice item category

    Retrieves the invoice item category with the given ID.

    GET /v2/invoice_item_categories/{INVOICE_ITEM_CATEGORY_ID}

  • Write

    Create an invoice item category

    Creates a new invoice item category object.

    POST /v2/invoice_item_categories

  • Write

    Update an invoice item category

    Updates the specific invoice item category by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/invoice_item_categories/{INVOICE_ITEM_CATEGORY_ID}

  • Destructive

    Delete an invoice item category

    Delete an invoice item category. Deleting an invoice item category is only possible if use_as_service and use_as_expense are both false.

    DELETE /v2/invoice_item_categories/{INVOICE_ITEM_CATEGORY_ID}

Invoice Messages

  • Read

    List all messages for an invoice

    Returns a list of messages associated with a given invoice. The invoice messages are returned sorted by creation date, with the most recently created messages appearing first.

    GET /v2/invoices/{INVOICE_ID}/messages

  • Read

    Retrieve invoice message subject and body for specific invoice

    Does not create the invoice message.

    GET /v2/invoices/{INVOICE_ID}/messages/new

  • Write

    Create and send an invoice message

    Creates a new invoice message object and sends it.

    POST /v2/invoices/{INVOICE_ID}/messages

  • Destructive

    Delete an invoice message

    Delete an invoice message.

    DELETE /v2/invoices/{INVOICE_ID}/messages/{message_ID}

Invoice Payments

  • Read

    List all payments for an invoice

    Returns a list of payments associate with a given invoice. The payments are returned sorted by creation date, with the most recently created payments appearing first.

    GET /v2/invoices/{INVOICE_ID}/payments

  • Write

    Create an invoice payment

    Creates a new invoice payment object.

    POST /v2/invoices/{INVOICE_ID}/payments

  • Destructive

    Delete an invoice payment

    Delete an invoice payment.

    DELETE /v2/invoices/{INVOICE_ID}/payments/{PAYMENT_ID}

Invoices

  • Read

    List all invoices

    Returns a list of your invoices. The invoices are returned sorted by issue date, with the most recently issued invoices appearing first.

    GET /v2/invoices

  • Read

    Retrieve an invoice

    Retrieves the invoice with the given ID.

    GET /v2/invoices/{INVOICE_ID}

  • Read

    Retrieve an e-invoice status

    Retrieves the Peppol readiness and the latest submission status for an invoice.

    GET /v2/invoices/{INVOICE_ID}/e_invoice_status

  • Write

    Create a free-form invoice

    Creates a new invoice object.

    POST /v2/invoices

  • Write

    Update an invoice

    Updates the specific invoice by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/invoices/{INVOICE_ID}

  • Write

    Send an e-invoice

    Sends an invoice over the Peppol network. The recipient’s Peppol identifier and the company’s legal-entity information are used, and the document is rendered for you.

    POST /v2/invoices/{INVOICE_ID}/send_e_invoice

  • Destructive

    Delete an invoice

    Delete an invoice.

    DELETE /v2/invoices/{INVOICE_ID}

Notification Preferences

  • Read

    Retrieve notification preferences

    Returns the notification preferences for the authenticated user.

    GET /v2/notification_preferences

  • Write

    Update notification preferences

    Updates the authenticated user’s notification preferences. Every key is optional, and omitted keys keep their current value.

    PATCH /v2/notification_preferences

  • Write

    Update notification preferences with PUT

    Update notification preferences with PUT.

    PUT /v2/notification_preferences

Notifications

  • Read

    List all notifications

    Returns a list of the authenticated user’s notifications, newest first. The response contains an object with a notifications property that contains an array of up to per_page notifications.

    GET /v2/notifications

  • Read

    Retrieve the unread count

    Returns the number of unread notifications for the authenticated user, with a breakdown by category. This endpoint takes no parameters.

    GET /v2/notifications/unread_count

  • Read

    Peek at notifications

    Returns up to six of the authenticated user’s most recent notifications, along with the unread count. The response has no pagination envelope.

    GET /v2/notifications/peek

  • Write

    Mark a notification as read

    Marks a single notification as read and returns the updated unread count. Reading an already-read notification returns the same count without changing the notification.

    POST /v2/notifications/{NOTIFICATION_ID}/mark_read

  • Write

    Mark all notifications as read

    Marks all of the authenticated user’s unread notifications as read and returns the updated unread count. Calling this endpoint when there are no unread notifications returns the same count and is not an error.

    POST /v2/notifications/mark_all_read

Projects

  • Read

    List all projects

    Returns a list of your projects. The projects are returned sorted by creation date, with the most recently created projects appearing first.

    GET /v2/projects

  • Read

    Retrieve a project

    Retrieves the project with the given ID.

    GET /v2/projects/{PROJECT_ID}

  • Write

    Create a project

    Creates a new project object.

    POST /v2/projects

  • Write

    Update a project

    Updates the specific project by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/projects/{PROJECT_ID}

  • Destructive

    Delete a project

    Deletes a project and any time entries or expenses tracked to it. However, invoices associated with the project will not be deleted.

    DELETE /v2/projects/{PROJECT_ID}

Tags

  • Read

    List all tags

    Returns the tag vocabulary for the account. The tags are returned sorted by name, then by id.

    GET /v2/tags

Project Task Assignments

  • Read

    List all task assignments

    Returns a list of your task assignments. The task assignments are returned sorted by creation date, with the most recently created task assignments appearing first.

    GET /v2/task_assignments

  • Read

    List all task assignments for a specific project

    Returns a list of your task assignments for the project identified by PROJECT_ID. The task assignments are returned sorted by creation date, with the most recently created task assignments appearing first.

    GET /v2/projects/{PROJECT_ID}/task_assignments

  • Read

    Retrieve a task assignment

    Retrieves the task assignment with the given ID.

    GET /v2/projects/{PROJECT_ID}/task_assignments/{TASK_ASSIGNMENT_ID}

  • Write

    Create a task assignment

    Creates a new task assignment object.

    POST /v2/projects/{PROJECT_ID}/task_assignments

  • Write

    Update a task assignment

    Updates the specific task assignment by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/projects/{PROJECT_ID}/task_assignments/{TASK_ASSIGNMENT_ID}

  • Destructive

    Delete a task assignment

    Delete a task assignment. Deleting a task assignment is only possible if it has no time entries associated with it.

    DELETE /v2/projects/{PROJECT_ID}/task_assignments/{TASK_ASSIGNMENT_ID}

Project User Assignments

  • Read

    List all user assignments

    Returns a list of your projects user assignments, active and archived. The user assignments are returned sorted by creation date, with the most recently created user assignments appearing first.

    GET /v2/user_assignments

  • Read

    List all user assignments for a specific project

    Returns a list of user assignments for the project identified by PROJECT_ID. The user assignments are returned sorted by creation date, with the most recently created user assignments appearing first.

    GET /v2/projects/{PROJECT_ID}/user_assignments

  • Read

    Retrieve a user assignment

    Retrieves the user assignment with the given ID.

    GET /v2/projects/{PROJECT_ID}/user_assignments/{USER_ASSIGNMENT_ID}

  • Write

    Create a user assignment

    Creates a new user assignment object.

    POST /v2/projects/{PROJECT_ID}/user_assignments

  • Write

    Update a user assignment

    Updates the specific user assignment by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/projects/{PROJECT_ID}/user_assignments/{USER_ASSIGNMENT_ID}

  • Destructive

    Delete a user assignment

    Delete a user assignment. Deleting a user assignment is only possible if it has no time entries or expenses associated with it.

    DELETE /v2/projects/{PROJECT_ID}/user_assignments/{USER_ASSIGNMENT_ID}

User Assignments & Allocations

  • Read

    List user assignments

    Returns a list of users alongside their assigned holiday calendars, assigned work schedules, and effective working hours.

    GET /v2/pto/assignments

  • Read

    List user allocations

    Returns a list of customized and yearly time off allocations across users. The response contains an object with a pto_allocations property that contains an array of up to per_page allocations.

    GET /v2/pto/allocations

  • Write

    Update user assignments

    Assigns or unassigns a holiday calendar and work schedule for a specific user.

    PATCH /v2/pto/assignments/{USER_ID}

  • Write

    Update or reset a user allocation

    Updates or resets per-user yearly allocation overrides.

    PATCH /v2/pto/allocations

  • Write

    Bulk update user allocations

    Updates or resets per-user yearly allocation overrides for many users in one request. Each item can also assign that person’s holiday calendar.

    PATCH /v2/pto/allocations/bulk

Holiday Calendars

  • Read

    List all holiday calendars

    Returns a list of holiday calendars. The response contains an object with a pto_holiday_calendars property that contains an array of up to per_page holiday calendars.

    GET /v2/pto/holiday_calendars

  • Read

    Retrieve a holiday calendar

    Retrieves the details of an existing holiday calendar.

    GET /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}

  • Read

    List entries in a holiday calendar

    Returns a list of holiday entries for the calendar identified by HOLIDAY_CALENDAR_ID. The response contains an object with a pto_holiday_calendar_entries property that contains an array of up to per_page entries.

    GET /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}/entries

  • Write

    Create a holiday calendar

    Creates a new holiday calendar.

    POST /v2/pto/holiday_calendars

  • Write

    Update a holiday calendar

    Updates an existing holiday calendar.

    PATCH /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}

  • Write

    Create an entry in a holiday calendar

    Creates one or more holiday entries in a calendar. Supports a single date or a range of dates.

    POST /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}/entries

  • Write

    Update a holiday calendar entry

    Updates an existing holiday calendar entry.

    PATCH /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}/entries/{ENTRY_ID}

  • Destructive

    Delete a holiday calendar

    Deletes a holiday calendar.

    DELETE /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}

  • Destructive

    Delete a holiday calendar entry

    Deletes a holiday calendar entry.

    DELETE /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}/entries/{ENTRY_ID}

Time Off Balances

  • Read

    Retrieve time off balances

    Returns time off balances broken down per policy for a specific user and year.

    GET /v2/pto/balances

Time Off Policies

  • Read

    List all time off policies

    Returns a list of time off policies. The response contains an object with a pto_types property that contains an array of up to per_page time off policies.

    GET /v2/pto/types

  • Read

    Retrieve a time off policy

    Retrieves the details of an existing time off policy.

    GET /v2/pto/types/{PTO_TYPE_ID}

  • Write

    Create a time off policy

    Creates a new time off policy.

    POST /v2/pto/types

  • Write

    Update a time off policy

    Updates an existing time off policy.

    PATCH /v2/pto/types/{PTO_TYPE_ID}

  • Destructive

    Delete a time off policy

    Deletes or deactivates an existing time off policy. By default, time off policies are deactivated rather than permanently deleted so historical requests and allocations remain preserved.

    DELETE /v2/pto/types/{PTO_TYPE_ID}

Time Off Requests

  • Read

    List all time off requests

    Returns a list of time off requests. The response contains an object with a pto_requests property that contains an array of up to per_page time off requests.

    GET /v2/pto/requests

  • Read

    Retrieve a time off request

    Retrieves the details of an existing time off request.

    GET /v2/pto/requests/{PTO_REQUEST_ID}

  • Write

    Create a time off request

    Creates a new time off request.

    POST /v2/pto/requests

  • Write

    Update a time off request

    Updates an unreviewed time off request. Only pending or changes_requested requests can be edited.

    PATCH /v2/pto/requests/{PTO_REQUEST_ID}

  • Write

    Approve a time off request

    Approves a pending or changes_requested request.

    POST /v2/pto/requests/{PTO_REQUEST_ID}/approve

  • Write

    Decline a time off request

    Declines a time off request.

    POST /v2/pto/requests/{PTO_REQUEST_ID}/decline

  • Write

    Request changes on a time off request

    Requests changes on a time off request.

    POST /v2/pto/requests/{PTO_REQUEST_ID}/request_changes

  • Write

    Approve multiple time off requests

    Approves every pending request in the given set. Requests that are not pending — changes_requested or already decided — are not reviewed and are returned in skipped_ids.

    POST /v2/pto/requests/approve

  • Write

    Decline multiple time off requests

    Declines every pending request in the given set. Requests that are not pending — changes_requested or already decided — are not reviewed and are returned in skipped_ids.

    POST /v2/pto/requests/decline

  • Destructive

    Cancel a time off request

    Cancels a time off request. The request is not deleted from Harvest; instead, its status is updated to cancelled and it remains visible in request listings.

    DELETE /v2/pto/requests/{PTO_REQUEST_ID}

Work Schedules

  • Read

    List all work schedules

    Returns a list of work schedules. The response contains an object with a pto_work_schedules property that contains an array of up to per_page work schedules.

    GET /v2/pto/work_schedules

  • Read

    Retrieve a work schedule

    Retrieves the details of an existing work schedule.

    GET /v2/pto/work_schedules/{WORK_SCHEDULE_ID}

  • Write

    Create a work schedule

    Creates a new work schedule.

    POST /v2/pto/work_schedules

  • Write

    Update a work schedule

    Updates an existing work schedule.

    PATCH /v2/pto/work_schedules/{WORK_SCHEDULE_ID}

  • Destructive

    Deactivate a work schedule

    Deactivates a non-default work schedule.

    DELETE /v2/pto/work_schedules/{WORK_SCHEDULE_ID}

Reimbursements

  • Read

    List all reimbursements

    Returns a list of reimbursement requests, scoped to what the caller can see. The response contains an object with a reimbursements property that contains an array of up to per_page reimbursement objects.

    GET /v2/reimbursements

  • Write

    Reject a reimbursement

    Rejects a reimbursement request.

    POST /v2/reimbursements/{REIMBURSEMENT_ID}/reject

  • Write

    Restore a reimbursement

    Restores a rejected reimbursement request, clearing its rejection reason.

    POST /v2/reimbursements/{REIMBURSEMENT_ID}/restore

Detailed Reports

  • Read

    Time Detailed Report

    Returns the time detailed report for time tracked over a date range.

    GET /v2/reports/time/detailed

  • Read

    Expense Detailed Report

    Returns the expense detailed report for expense tracked over a date range.

    GET /v2/reports/expenses/detailed

Expense Reports

  • Read

    Clients Report

    Returns the clients report for expense tracked over a date range.

    GET /v2/reports/expenses/clients

  • Read

    Projects Report

    Returns the projects report for expense tracked over a date range.

    GET /v2/reports/expenses/projects

  • Read

    Expense Categories Report

    Returns the expense categories report for expense tracked over a date range.

    GET /v2/reports/expenses/categories

  • Read

    Team Report

    Returns the team report for expense tracked over a date range.

    GET /v2/reports/expenses/team

Profitability Report

  • Read

    Profitability Report

    Returns the profitability report over a date range.

    GET /v2/reports/profitability

Project Budget Report

  • Read

    Project Budget Report

    Returns the project budget report over a date range.

    GET /v2/reports/project_budget

Report Exports

  • Read

    Retrieve a report export

    Retrieves the status of an export.

    GET /v2/reports/exports/{EXPORT_ID}

  • Read

    Download a report export

    Downloads the finished report export file.

    GET /v2/reports/exports/{EXPORT_ID}/download

  • Write

    Create a report export

    Creates a report export.

    POST /v2/reports/exports

Saved and Generated Reports

  • Read

    List all saved reports

    Returns a list of saved reports, ordered by updated_at descending, then id descending. The response contains an object with a saved_reports property that contains an array of up to per_page saved report objects.

    GET /v2/reports/saved

  • Read

    Retrieve a saved report

    Retrieves a saved report.

    GET /v2/reports/saved/{SAVED_REPORT_ID}

  • Read

    Run a saved report

    Runs the stored definition of a saved report.

    GET /v2/reports/generated/{SAVED_REPORT_ID}

  • Write

    Create a saved report

    Creates a saved report.

    POST /v2/reports/saved

  • Write

    Update a saved report

    Updates a saved report.

    PATCH /v2/reports/saved/{SAVED_REPORT_ID}

  • Write

    Generate a report

    Runs a report definition supplied in the request.

    POST /v2/reports/generate

  • Destructive

    Delete a saved report

    Deletes a saved report.

    DELETE /v2/reports/saved/{SAVED_REPORT_ID}

Time Reports

  • Read

    Clients Report

    Returns the clients report for time tracked over a date range.

    GET /v2/reports/time/clients

  • Read

    Projects Report

    Returns the projects report for time tracked over a date range.

    GET /v2/reports/time/projects

  • Read

    Tasks Report

    Returns the tasks report for time tracked over a date range.

    GET /v2/reports/time/tasks

  • Read

    Team Report

    Returns the team report for time tracked over a date range.

    GET /v2/reports/time/team

Uninvoiced Report

  • Read

    Uninvoiced Report

    Returns the uninvoiced report over a date range.

    GET /v2/reports/uninvoiced

Custom Roles

  • Read

    List all custom roles

    Returns a list of the account’s custom roles, sorted by descending ID. The response contains an object with a custom_roles property that contains an array of up to per_page custom roles.

    GET /v2/custom_roles

  • Read

    Retrieve a custom role

    Retrieves the custom role with the given ID.

    GET /v2/custom_roles/{CUSTOM_ROLE_ID}

  • Write

    Create a custom role

    Creates a custom role. An account can have a maximum of 50 custom roles.

    POST /v2/custom_roles

  • Write

    Update a custom role

    Updates the custom role with the given ID by setting the values of the parameters passed. Any parameters not provided are left unchanged.

    PATCH /v2/custom_roles/{CUSTOM_ROLE_ID}

  • Destructive

    Delete a custom role

    Deletes the custom role with the given ID.

    DELETE /v2/custom_roles/{CUSTOM_ROLE_ID}

Permissions

  • Read

    List all permissions

    Returns the account’s permission catalogue, sorted by ascending ID. The catalogue is the set of permissions the account can grant, and Forecast permissions are excluded.

    GET /v2/permissions

Roles

  • Read

    List all roles

    Returns a list of roles in the account. The roles are returned sorted by creation date, with the most recently created roles appearing first.

    GET /v2/roles

  • Read

    Retrieve a role

    Retrieves the role with the given ID.

    GET /v2/roles/{ROLE_ID}

  • Write

    Create a role

    Creates a new role object.

    POST /v2/roles

  • Write

    Update a role

    Updates the specific role by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/roles/{ROLE_ID}

  • Destructive

    Delete a role

    Delete a role. Deleting a role will unlink it from any users it was assigned to.

    DELETE /v2/roles/{ROLE_ID}

Tasks

  • Read

    List all tasks

    Returns a list of your tasks. The tasks are returned sorted by creation date, with the most recently created tasks appearing first.

    GET /v2/tasks

  • Read

    Retrieve a task

    Retrieves the task with the given ID.

    GET /v2/tasks/{TASK_ID}

  • Write

    Create a task

    Creates a new task object.

    POST /v2/tasks

  • Write

    Update a task

    Updates the specific task by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/tasks/{TASK_ID}

  • Destructive

    Delete a task

    Delete a task. Deleting a task is only possible if it has no time entries associated with it.

    DELETE /v2/tasks/{TASK_ID}

Time Entries

  • Read

    List all time entries

    Returns a list of time entries. The time entries are returned sorted by spent_date date.

    GET /v2/time_entries

  • Read

    Retrieve a time entry

    Retrieves the time entry with the given ID.

    GET /v2/time_entries/{TIME_ENTRY_ID}

  • Write

    Create a time entry via duration

    Creates a new time entry object.

    POST /v2/time_entries

  • Write

    Update a time entry

    Updates the specific time entry by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/time_entries/{TIME_ENTRY_ID}

  • Write

    Restart a stopped time entry

    Restarting a time entry is only possible if it isn’t currently running.

    PATCH /v2/time_entries/{TIME_ENTRY_ID}/restart

  • Write

    Stop a running time entry

    Stopping a time entry is only possible if it’s currently running.

    PATCH /v2/time_entries/{TIME_ENTRY_ID}/stop

  • Destructive

    Delete a time entry’s external reference

    Delete a time entry’s external reference.

    DELETE /v2/time_entries/{TIME_ENTRY_ID}/external_reference

  • Destructive

    Delete a time entry

    Delete a time entry. Deleting a time entry is only possible if it’s not closed and the associated project and task haven’t been archived.

    DELETE /v2/time_entries/{TIME_ENTRY_ID}

User Billable Rates

  • Read

    List all billable rates for a specific user

    Returns a list of billable rates for the user identified by USER_ID. The billable rates are returned sorted by start_date, with the oldest starting billable rates appearing first.

    GET /v2/users/{USER_ID}/billable_rates

  • Read

    Retrieve a billable rate

    Retrieves the billable rate with the given ID.

    GET /v2/users/{USER_ID}/billable_rates/{billable_RATE_ID}

  • Write

    Create a billable rate

    Creates a new billable rate object.

    POST /v2/users/{USER_ID}/billable_rates

User Cost Rates

  • Read

    List all cost rates for a specific user

    Returns a list of cost rates for the user identified by USER_ID. The cost rates are returned sorted by start_date, with the oldest starting cost rates appearing first.

    GET /v2/users/{USER_ID}/cost_rates

  • Read

    Retrieve a cost rate

    Retrieves the cost rate with the given ID.

    GET /v2/users/{USER_ID}/cost_rates/{COST_RATE_ID}

  • Write

    Create a cost rate

    Creates a new cost rate object.

    POST /v2/users/{USER_ID}/cost_rates

User Project Assignments

  • Read

    List active project assignments

    Returns a list of active project assignments for the user identified by USER_ID. The project assignments are returned sorted by creation date, with the most recently created project assignments appearing first.

    GET /v2/users/{USER_ID}/project_assignments

  • Read

    List active project assignments for the currently authenticated user

    Returns a list of your active project assignments for the currently authenticated user. The project assignments are returned sorted by creation date, with the most recently created project assignments appearing first.

    GET /v2/users/me/project_assignments

User Teammates

  • Read

    List all assigned teammates for a specific user

    Returns a list of assigned teammates for the user identified by USER_ID. The USER_ID must belong to a user that is a Manager, if not, a 422 Unprocessable Entity status code will be returned.

    GET /v2/users/{USER_ID}/teammates

  • Write

    Update a user’s assigned teammates

    Updates the the assigned teammates for a specific user.

    PATCH /v2/users/{USER_ID}/teammates

Users

  • Read

    List all users

    Returns a list of your users. The users are returned sorted by creation date, with the most recently created users appearing first.

    GET /v2/users

  • Read

    Retrieve the currently authenticated user

    Retrieves the currently authenticated user.

    GET /v2/users/me

  • Read

    Retrieve a user

    Retrieves the user with the given ID.

    GET /v2/users/{USER_ID}

  • Write

    Create a user

    Creates a new user object and sends an invitation email to the address specified in the email parameter.

    POST /v2/users

  • Destructive

    Update a user

    Updates the specific user by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

    PATCH /v2/users/{USER_ID}

  • Destructive

    Delete a user

    Delete a user. Deleting a user is only possible if they have no time entries or expenses associated with them.

    DELETE /v2/users/{USER_ID}

See How connections work for access and permissions, or browse all integrations.

Reference date: October 28, 2026. Harvest API docs.