API Reference

The MonitoringDog API allows you to programmatically manage your monitors, incidents, and status pages.

Base URL

All API requests should be made to:

https://api.monitoringdog.com/v1

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.monitoringdog.com/v1/monitors

You can generate API keys from your dashboard under Settings > API Keys.

Endpoints

Monitors

Method	Endpoint	Description
GET	/monitors	List all monitors
POST	/monitors	Create a new monitor
GET	/monitors/:id	Get a specific monitor
PUT	/monitors/:id	Update a monitor
DELETE	/monitors/:id	Delete a monitor
POST	/monitors/:id/pause	Pause a monitor
POST	/monitors/:id/resume	Resume a monitor

Incidents

Method	Endpoint	Description
GET	/incidents	List all incidents
POST	/incidents	Create an incident
GET	/incidents/:id	Get incident details
PUT	/incidents/:id	Update an incident
POST	/incidents/:id/resolve	Resolve an incident

Status Pages

Method	Endpoint	Description
GET	/status-pages	List all status pages
POST	/status-pages	Create a status page
GET	/status-pages/:id	Get status page details
PUT	/status-pages/:id	Update a status page

Rate Limits

• Free tier: 100 requests per minute
• Pro tier: 1,000 requests per minute
• Business tier: 10,000 requests per minute

When you exceed your rate limit, the API will return a 429 Too Many Requests response.

Errors

The API uses standard HTTP status codes:

Status	Description
200	Success
201	Created
400	Bad request
401	Unauthorized
404	Not found
429	Rate limited
500	Server error

SDKs

Official SDKs are available for:

• JavaScript/TypeScript (npm: @monitoringdog/sdk)
• Python (pip: monitoringdog)
• Go (go get: github.com/monitoringdog/go-sdk)

Need Help?

• Check our GitHub for examples
• Email support@monitoringdog.com for assistance