API
Every resource, one versioned REST API
Monitors, dashboards, alert rules, incidents, reports, organizations, and billing — all provisionable through the same API the MonSPHERE dashboard itself calls.
Authentication
Two ways to authenticate
JWT bearer tokens
POST /api/v1/auth/login returns a short-lived access token and a refresh token. Send the access token as a standard bearer token on every request.
If the account has MFA enabled, login instead returns a challenge token; redeem it via POST /api/v1/auth/mfa/verify with a TOTP or backup code to get real tokens.
curl -X POST https://api.monsphere.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"you@company.com","password":"••••••••"}'
curl https://api.monsphere.com/api/v1/monitors \
-H "Authorization: Bearer $ACCESS_TOKEN"Pagination & Filtering
Consistent across every list endpoint
Pagination
?page=— 1-indexed page number?pageSize=— items per page, default 20, max 100
Every list response returns { data, meta: { page, pageSize, totalItems } }.
Filtering & sorting
?search=— free-text search on supported fields?sort=field— ascending; prefix with-for descending
Sortable fields are allow-listed per endpoint to keep queries fast.
Example
List monitors, paginated and sorted
curl "https://api.monsphere.com/api/v1/monitors?page=1&pageSize=20&sort=-createdAt" \
-H "X-Api-Key: msk_live_51H8x..."
# {
# "data": [ { "id": "...", "name": "Production API", "type": "https", "currentStatus": "up" }, ... ],
# "meta": { "page": 1, "pageSize": 20, "totalItems": 47 }
# }Start monitoring everything in minutes
Join thousands of teams who trust MonSPHERE to keep their systems online, fast, and observable.