Introduction

The Varen API lets you manage monitors, query changes, and receive webhook notifications programmatically. All endpoints are under https://api.varen.dev/v1/.

Authentication

All endpoints require a Bearer API key (except where noted). Create keys from Dashboard → Settings → API Keys.

curl https://api.varen.dev/v1/monitors \
  -H "Authorization: Bearer vk_your_key_here"

Plan access

Rate limits

• Authenticated requests: 60/min per user
• On-demand scans: 3/min per user

Rate limit info is returned in response headers:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

Response format

All responses follow a consistent format:

Success:

{
  "data": { ... },
  "meta": { "total": 42, "page": 1, "per_page": 20 }
}

Error:

{
  "error": {
    "code": "not_found",
    "message": "Monitor not found"
  }
}

Next steps

• Monitors — manage your monitored APIs
• Changes — query detected changes
• Health — API health scores
• Catalog — browse available APIs
• Destinations — webhook configuration