UptimeTea

API Documentation

The UptimeTea API is easy to use and free for all plans.

Get watcher

Returns a single watcher by ID. Optionally include check history with time range filtering.

GET
https://api.uptimetea.com/watchers/:id

Query parameters

range
STRING

Time range for checks: 24h, 7d, 30d, or 90d

start_date
STRING

Custom start date (ISO 8601 format)

end_date
STRING

Custom end date (ISO 8601 format)

Headers

Authorization
REQUIRED
STRING
Bearer $TOKEN

Response body

{
  "id": "uuid",
  "title": "My Website",
  "category": "uptime",
  "url": "https://example.com",
  "status": "up",
  "tags": ["production", "critical"],
  "last_checked_at": "2024-01-15T10:30:00Z",
  "uptime_percentage": 99.5,
  "consecutive_failures": 0,
  "in_maintenance": false,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "checks": [...],
  "total_checks": 100,
  "average_response_time": 234.56
}

Code Examples

curl -X GET "https://api.uptimetea.com/watchers/<watcher_id>?range=7d" \
  -H "Authorization: Bearer $TOKEN"