Skip to main content
Health checks monitor your websites and APIs, alerting you when they go down.

​
Creating a Health Check

  1. Go to Health Checks in the dashboard
  2. Click Add Health Check
  3. Fill in the details:
FieldDescriptionExample
NameDisplay nameProduction API
URLFull URL to checkhttps://api.example.com/health
MethodHTTP methodGET, POST, HEAD
IntervalCheck frequency30 (seconds)
TimeoutMax response time10 (seconds)
  1. Click Create

​
How It Works

Every interval, we:
  1. Send an HTTP request to your URL
  2. Record response time and status code
  3. Mark as UP if status is 2xx, DOWN otherwise
  4. Send alert if status changes

​
Alert Behavior

  • First failure: Wait and retry
  • Confirmed down: Send alert after multiple failures
  • Recovery: Send “back up” notification
We use confirmation checks to avoid false alerts from temporary network issues.

​
Expected Status Codes

By default, 2xx responses are considered healthy. You can customize:
ExpectedBehavior
200Only 200 is healthy
200,201200 or 201 is healthy
2xxAny 200-299 is healthy

​
Keyword Matching

Optionally check that the response contains specific text:
FieldDescription
KeywordText to find in response
Modecontains or not_contains
Example: Check that your API returns "status":"ok".

​
Retry Settings

SettingDescriptionDefault
RetriesNumber of retry attempts3
Retry IntervalSeconds between retries10

​
Uptime Statistics

For each health check, you’ll see:
  • 24h Uptime: Last 24 hours
  • 7d Uptime: Last 7 days
  • 30d Uptime: Last 30 days
  • Response Time: Average, min, max

​
Public Status Pages

Requires PRO plan
Share a public status page with your users:
  1. Go to the health check settings
  2. Enable “Public Status Page”
  3. Copy the public URL
Your users can see uptime status without logging in.

​
Incidents

When a health check fails, an incident is created:
  • Start time
  • Error message or status code
  • Duration (when recovered)
View incident history in the Health Check details.

​
Best Practices

Create a /health endpoint that checks critical dependencies:
{
  "status": "ok",
  "database": "connected",
  "redis": "connected"
}
  • Critical services: Every 30 seconds
  • Regular websites: Every 60 seconds
  • Non-critical: Every 5 minutes
Set timeout higher than your typical response time. If your API responds in 500ms, use 5-10s timeout.

​
Limits

PlanHealth Checks
Free3
PROUnlimited