Clockify API

Beginner's Pick Documents & Productivity / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

Clockify is a free time-tracking API that lets you manage workspaces, projects, clients, and time entries programmatically. It is useful for automating timesheet reporting, syncing tracked hours with invoicing systems, or building custom dashboards. The free tier is generous and the API is well-documented with clear examples.

Beginner Tip

Your workspace ID is required in nearly every Clockify API call — retrieve it first with GET /workspaces using just your API key, then store it for subsequent requests.

Available Data

Clockify data via REST API

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Clockify",
    "description": "Clockify's REST-based API can be used to push/pull data to/from it & integrate it with other systems",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

id Unique identifier for the workspace, project, or time entry object.
name Human-readable name of the workspace or project.
timeInterval Start and end timestamps for a time entry in ISO 8601 format.
timeInterval.start ISO 8601 datetime when the timer was started.
timeInterval.end ISO 8601 datetime when the timer was stopped; null if still running.
duration Total duration of the time entry in ISO 8601 duration format (e.g., PT1H30M).

Implementation Example

Request
const url = "https://clockify.me/developers-api";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized The X-Api-Key header is missing or the key is invalid.
Generate an API key in Clockify under Profile Settings > API and pass it in the X-Api-Key header.
403 Forbidden You are trying to access a workspace or resource you are not a member of.
Use the /workspaces endpoint to list only the workspaces your account belongs to.
404 Not Found The workspace ID, project ID, or time entry ID in the URL path is incorrect.
Look up the correct ID from a parent list endpoint before using it in detail endpoints.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Difficulty Intermediate
Verified: 2026-04-07

Similar APIs

View All →