Vantaj
Back to home
API

Monitoring API

Programmatic access to everything in Vantaj. Create monitors, manage incidents, pull metrics, and automate your entire monitoring infrastructure with a simple REST API.

Get started freeRead the docs
$ vantaj add https://api.acme.com
→ Probing from us-east, eu-west, ap-southeast...
→ 231ms · 248ms · 289ms all healthy
→ Alert contact: [email protected] ✓
→ Check interval: every 1 min ✓
✓ Monitor live — app.vantaj.co/

Create a monitor in one request

curl
$ curl -X POST https://api.vantaj.co/v1/monitors \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "url": "https://api.acme.com/health",
    "type": "http",
    "interval": 60,
    "regions": ["us-east", "eu-west", "ap-southeast"],
    "alerts": {
      "email": ["[email protected]"],
      "slack": "#incidents"
    }
  }'

// → 201 Created
{
  "id": "mon_a1b2c3d4",
  "status": "active",
  "next_check": "2026-06-05T12:00:00Z"
}

API endpoints

Method Endpoint
GET/monitors
POST/monitors
PATCH/monitors/:id
DELETE/monitors/:id
GET/monitors/:id/metrics
GET/incidents
POST/incidents
GET/status-pages
POST/status-pages/:id/updates

Built for developers

RESTful design

Clean, predictable endpoints that follow REST conventions. JSON in, JSON out.

API key authentication

Simple Bearer token auth. Generate and rotate keys from the dashboard.

Webhooks

Get notified in real-time when monitors change state, incidents open, or SSL certs are expiring.

Rate-limited & fair

100 requests/minute on free tier, 1000/minute on paid plans. Generous enough for any automation.

CI/CD integration

Create monitors on deploy, pause during maintenance windows, and tear down on branch cleanup.

Metrics export

Pull uptime percentages, response time percentiles, and incident data into your own dashboards.

What you can build

01

Infrastructure as Code

Define your monitoring configuration alongside your infrastructure. Create monitors automatically when you deploy a new service — tear them down when you decommission.

02

Custom dashboards

Pull response time metrics, uptime percentages, and incident history into Grafana, Datadog, or your own internal tools via the metrics API.

03

ChatOps & automation

Build Slack bots that create monitors, post incident updates, or pause checks during maintenance — all through the API.

04

Multi-tenant monitoring

Agencies and SaaS platforms can programmatically manage monitors for each client, with separate status pages and alert configurations.

Frequently asked questions

What authentication does the API use?
Bearer token authentication. Generate API keys from your Vantaj dashboard under Settings → API Keys. You can create multiple keys with different permissions.
Is there a rate limit?
Yes. Free tier: 100 requests/minute. Developer: 500/minute. Team & Enterprise: 1000/minute. Rate limit headers are included in every response.
Can I create monitors via the API?
Yes. You can create, update, delete, and pause any monitor type — HTTP, heartbeat, keyword, SSL, and domain — entirely through the API.
Does the API support webhooks?
Yes. Configure webhook endpoints in your dashboard or via the API. Vantaj sends signed payloads for monitor state changes, incidents, SSL expiry warnings, and more.
Is there an SDK?
We provide official SDKs for Node.js/TypeScript, Python, and Go. Community SDKs are available for Ruby, PHP, and Rust.
Can I use the API on the free tier?
Yes. API access is available on all plans, including free. The only difference is rate limits and the number of monitors you can create.

Start building with the Vantaj API

Free tier includes API access with 100 requests/minute. Create your first monitor programmatically in under a minute.

Get your API keyAPI docs