AriaTimer API

🟡 Checking...

Complete HTTP API for remote control of timers, messages, and room settings. Perfect for integrations, automation, and custom applications.

Interactive API Docs

Live API documentation with examples

Test API

Check API connectivity and status

Full Documentation

Complete API guide and examples

🚀 Quick Start Example

# Test API connection
curl "/api/v1/test"

# Start a timer
curl -X POST -H "Content-Type: application/json" \
  -d '{"action":"start"}' \
  "/api/v1/rooms/YOUR_ROOM_ID/timers/TIMER_ID/actions"

Timer Control

Start, stop, pause, and reset timers remotely

Messages

Send messages to timer viewers

Webhooks

Receive real-time event notifications

Room Settings

Configure themes and room properties

Core API Endpoints

Room Management

GET/api/v1/rooms/{roomId}

PUT/api/v1/rooms/{roomId}

DELETE/api/v1/rooms/{roomId}

Timer Control

GET/api/v1/rooms/{roomId}/timers

POST/api/v1/rooms/{roomId}/timers

POST.../timers/{timerId}/actions

Messages

GET/api/v1/rooms/{roomId}/messages

POST/api/v1/rooms/{roomId}/messages

DELETE/api/v1/rooms/{roomId}/messages

Webhooks

GET/api/v1/rooms/{roomId}/webhooks

POST/api/v1/rooms/{roomId}/webhooks

DELETE/api/v1/rooms/{roomId}/webhooks

Back to Documentation