Focus Timer API
Single-purpose countdown for time-boxing deep work. Hours/minutes/seconds, six quick presets, audio cue at zero.
Fast & Accurate
Get precise results instantly.
Easy Integration
Simple REST API with JSON response.
Developer Friendly
Clear docs and SDK examples.
Free to Start
5,000 free requests/month.
Endpoint
All requests should be made to the following endpoint:
GET https://api.tools.town/v1/productivity/focus-timer Authentication
This endpoint requires an API Key. Include your API key in the request header.
Request Parameters
Send a GET request with query parameters.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
hours | number | ✕ | The hours parameter. | 100 |
minutes | number | ✕ | The minutes parameter. | 100 |
seconds | number | ✕ | The seconds parameter. | 100 |
Example Request
curl -G "https://api.tools.town/v1/productivity/focus-timer" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "hours=100" \
--data-urlencode "minutes=100" \
--data-urlencode "seconds=100" Error Codes
| Code | Meaning |
|---|---|
| 400 | Bad Request — missing or invalid parameter |
| 401 | Unauthorized — API key missing or invalid |
| 429 | Rate limit exceeded — free tier: 5,000 requests/month |
| 500 | Internal Server Error — try again or contact support |