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
JSON-formatted response data
Requires API key authentication

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

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.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 2/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

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

Similar APIs

View All →