Skip to content
T
Tools.Town
Free Online Tools for Everyone

Focus Timer API

Single-purpose countdown for time-boxing deep work. Hours/minutes/seconds, six quick presets, audio cue at zero.

Category: Productivity Endpoint: /v1/productivity/focus-timer Method: GET Auth: API Key

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.

Authorization: Bearer YOUR_API_KEY
You can get your API key from your dashboard.

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