Timo Documentation

API Reference

Welcome to the Timo API documentation. Our REST API allows you to integrate Timo with your applications and automate time tracking workflows.

Base URL

All API requests should be made to:

https://api.timo.app/v1

Authentication

The Timo API uses API keys for authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

  • Free Plan: 100 requests per hour
  • Pro Plan: 1,000 requests per hour
  • Enterprise: 10,000 requests per hour

Response Format

All API responses are returned in JSON format with the following structure:

{
  "success": true,
  "data": { ... },
  "message": "Success message"
}

Error Handling

Errors are returned with appropriate HTTP status codes and error messages:

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request is invalid"
  }
}

Quick Start

  1. Get your API key
  2. Create your first time entry
  3. Set up a project
  4. Generate reports

SDKs

We provide official SDKs for popular languages:

  • JavaScript/TypeScript: npm install @timo/api-client
  • Python: pip install timo-api
  • PHP: composer require timo/api-client