Developer Resources

API Reference

Availability monitoring for Russian IT teams. Programmatic access to UptimeGuard for building, automating, and integrating uptime checks into your workflows.

Generate API Key Download OpenAPI Spec

Endpoints

All requests require a Bearer token in the Authorization header. Base URL: https://api.uptimeguard.io/v1

GET /monitors

Retrieve a paginated list of all active monitors associated with your workspace. Supports filtering by status, tags, and creation date.

POST /monitors

Create a new HTTP, TCP, or DNS monitor. Define check intervals, alert thresholds, and notification channels in the request payload.

GET /monitors/{id}/status

Fetch real-time uptime status, response times, and last check timestamp for a specific monitor ID.

PATCH /monitors/{id}

Update monitor configuration, toggle active/pause state, or modify alert routing without recreating the resource.

Code Examples

Quickstart snippets for authenticating and querying monitor status. Replace YOUR_API_KEY with your workspace secret.

cURL

curl -X GET "https://api.uptimeguard.io/v1/monitors/m-8f3a2c/status" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Python (requests)

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(
    "https://api.uptimeguard.io/v1/monitors/m-8f3a2c/status",
    headers=headers
)
print(response.json())

Expected Response

{
  "id": "m-8f3a2c",
  "name": "Payment Gateway API",
  "status": "healthy",
  "response_time_ms": 142,
  "last_check": "2024-05-18T09:14:22Z",
  "uptime_30d": 99.98
}

Rate Limits & Throttling

UptimeGuard enforces fair usage policies to maintain global probe network stability. Limits are applied per API key and reset on a rolling minute basis.

Free Tier

60 requests per minute. Returns 429 Too Many Requests with a Retry-After header when exceeded. Suitable for basic dashboard polling.

Pro Tier

300 requests per minute. Includes burst allowance of 50 additional requests for CI/CD trigger workflows. Contact support for custom scaling.

Enterprise Tier

Unlimited read endpoints. Write operations capped at 1,000 requests per minute. Dedicated rate limit configuration available via your account manager.

Implement exponential backoff in your integration logic. Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.