REST API v2.4

API Reference — VantaStatus

Мониторинг доступности российского интернета

Explore Endpoints Generate API Key

API Overview

Programmatically monitor service uptime, configure alerting rules, and retrieve historical latency data across 142 Russian exchange points. The VantaStatus REST API accepts JSON payloads and returns standardized responses with full pagination support.

Base URL

https://api.vantastatus.ru/v2

Rate Limit

120 requests per minute per API key

Response Format

JSON (application/json) with ISO 8601 timestamps

Endpoints List

Core routes for monitoring automation, alert management, and historical data retrieval.

GET /services

Retrieve paginated list of monitored services with current status codes and last check timestamps.

POST /alerts

Create webhook or email alert rules tied to specific latency thresholds or downtime events.

GET /history/:service_id

Fetch 90-day uptime metrics, packet loss percentages, and regional exchange point performance data.

Authentication

All API requests require a valid bearer token passed in the Authorization header. Tokens are generated from your VantaStatus dashboard under Settings > API Keys.

Header Format

Authorization: Bearer vs_live_8f3a2b9c1d4e5f6a7b8c9d0e1f2a3b4c

Token Lifecycle

API keys are permanent until revoked. Rotate keys immediately if exposed. No OAuth2 or session cookies supported.

Code Examples

Integrate VantaStatus into your automation pipelines using standard HTTP clients. Below is a Python and cURL implementation for fetching service status.

Python (requests)

import requests
headers = {"Authorization": "Bearer vs_live_8f3a2b9c..."}
res = requests.get("https://api.vantastatus.ru/v2/services", headers=headers)
print(res.json())

cURL

curl -X GET "https://api.vantastatus.ru/v2/services?limit=25" \\\n -H "Authorization: Bearer vs_live_8f3a2b9c..."

Terminal window showing successful API response with JSON service status data