ismysiteupDashboard →

API Documentation

Uptime, API, and data monitoring with instant alerts via email, Telegram, WhatsApp, and Slack. Data Monitors watch real values in your API responses (orders, signups, revenue) and catch failures that still return HTTP 200 — plus SSL-certificate and domain-name expiry monitoring, response-time tracking, incident history, and a built-in Postman-like API client with endpoint tests.

Base URL: https://ismysiteup.net/api/v1 · Rate limit: 120 requests/min per key

Authentication

Create a key under DevTools → API Keys. Keys are prefixed with imsu_ and carry scopes. Send it on every request:

Authorization: Bearer imsu_xxx
# or
X-API-Key: imsu_xxx

Scopes

  • monitors:read — Read monitor data (list, details, status)
  • monitors:write — Create, update, delete, toggle monitors
  • errors:read — Read error logs and incidents
  • errors:write — Acknowledge incidents, mark errors read
  • settings:read — Read notification settings
  • account:read — Read account info and subscription

Endpoints

GET/api/v1/dev/monitorsmonitors:read
POST/api/v1/dev/monitorsmonitors:write
GET/api/v1/dev/monitors/{id}monitors:read
PATCH/api/v1/dev/monitors/{id}monitors:write
DELETE/api/v1/dev/monitors/{id}monitors:write
POST/api/v1/dev/monitors/{id}/togglemonitors:write
GET/api/v1/dev/monitors/{id}/errorserrors:read
GET/api/v1/dev/monitors/{id}/incidentserrors:read
GET/api/v1/dev/accountaccount:read

Examples

List your monitors

curl https://ismysiteup.net/api/v1/dev/monitors \
  -H "Authorization: Bearer imsu_xxx"
const res = await fetch("https://ismysiteup.net/api/v1/dev/monitors", {
  headers: { Authorization: "Bearer imsu_xxx" },
});
const { data } = await res.json();

Create a monitor

curl -X POST https://ismysiteup.net/api/v1/dev/monitors \
  -H "Authorization: Bearer imsu_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","name":"My site","intervalSeconds":300,"expectedStatus":200,"timeout":30000}'

Responses

Every response is JSON. Success:

{ "success": true, "data": { ... }, "meta": { "total": 3 } }

Error:

{ "success": false, "error": { "code": "invalid_api_key", "message": "..." } }

Request model (API Client)

When building requests in the API Client:

  • Methods: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
  • Body types: none, json, raw, x-www-form-urlencoded, form-data
  • Auth types: none, inherit, bearer, basic, api-key

For AI tools

A machine-readable description of the app's capabilities (sections, request model, monitor conditions, test assertions, and this REST API) is available as JSON:

GET https://ismysiteup.net/api/v1/ai/context