REST API

Every paid plan includes a REST API. Anything you can do in the dashboard, you can automate: create and manage monitors, read check results and uptime history, open and resolve incidents, wire up alert channels and rules, schedule maintenance windows, manage status pages, inspect server-agent hosts and pull data exports.

The full reference is in your dashboard

The complete, always-current API reference (every endpoint, its parameters, example payloads and copy-ready cURL) is generated live from the running service and kept behind sign-in. You'll find it under Settings → API Keys → API Reference.

Open the API reference → (sign in to view)

Authentication

Create an API key in the dashboard under Settings → API Keys: the full key, prefixed 247m_, is shown once at creation. Send it with every request, either as a bearer token or an X-API-Key header:

curl https://app.247monitor.net/api/v1/monitors \
  -H "Authorization: Bearer 247m_your_key_here"

# or
curl https://app.247monitor.net/api/v1/monitors -H "X-API-Key: 247m_your_key_here"

Keys carry scopes: read (GET endpoints) and write (create, update, delete). A read-only key receives 403 on mutations. Keys act on your own team with the same limits as your plan; billing and team administration stay dashboard-only.

Base URL

https://app.247monitor.net/api/v1

Errors & limits

• 401: missing, invalid, or expired key.
• 403: read-only key on a mutation, a feature your plan doesn't include, or a plan quota reached (the message says which).
• Standard rate limits apply per client; if you receive 429, back off and retry.

Questions or missing endpoints? [email protected].