Getting Started with the API

Timesheets.com provides a public API for customer-side integrations, reporting, and account administration.

Base URL: https://secure.timesheets.com/api/public/v1/

Open the interactive API dashboard

Public API v1 Developer Guide

1. API Getting Started, Authentication & Responses

   Start here to authenticate, make your first request, interpret responses, and retrieve server metadata.

2. API Complete Endpoint Catalog

   A complete catalog of Public API v1 resources, methods, paths, and authentication requirements.

3. API Users, Assignments & Archiving

   Create and list users, manage customer/project/account-code assignments, and resolve archive blockers.

4. API Items: Customers, Projects, Account Codes, Vendors & Events

   Read account items and manage the vendor and event resources supported by Public API v1.

5. API Clock, Project Timers & Records

   Retrieve clock shifts and project timers, inspect record history, and generate expense-receipt PDFs.

6. API Reports

   Generate user, hourly, payroll, project, and expense reports with Public API v1.

7. API Workflows, Errors & Client Examples

   End-to-end integration workflows, common failure modes, and reusable Bash, Node.js, and Python clients.

Before you begin

• Only the Primary Administrator can generate API credentials.
• Treat API keys and tokens like passwords and store them outside source code.
• Use the exact authentication header names returned with the credentials.
• Most authenticated requests return HTTP 200 even when the response body contains application-level errors.
• The default rate limit is five requests per rolling 60 seconds per API key.