noc724 REST API.

noc724 has an easy-to-use API. It lets you get the details and uptime of your monitors, create / edit / delete monitors, status pages, maintenance windows and alert channels, and follow your incidents.

Response format

The API returns data in JSON format. Times are in UTC (ISO 8601).

Rate limits

To prevent abusive use of the API, the calls that do real work have per-minute limits:

Create a monitor : 30 req/min
Check a monitor now : 20 req/min
Send a test alert : 10 req/min
Send a heartbeat : 120 req/min ( per IP address )

We will return 429 HTTP status code in the response from API when you hit a rate limit, together with these response headers:

X-RateLimit-Limit - your current rate limit
X-RateLimit-Remaining - number of calls left in current duration
X-RateLimit-Reset - seconds until the rate limiting period ends
Retry-After - number of seconds after you should retry the call

Type of API keys

Requests are authenticated with HTTP Bearer authentication: send the key in the Authorization: Bearer YOUR_API_KEY header.

There are 3 types of API keys:

  • Main API key: Allows using all the API methods on everything in the account.
  • Monitor-specific API keys: Allows using only the getMonitor method (and the GET methods under it) for the given monitor.
  • Read-only API key: Allows fetching data with all the GET API endpoints.

How to get API keys

You can get your API keys from the Integrations page under section API.