Usage & Telemetry Reference

Endpoints for querying API request volume, latencies, and operational logs.

GET

/api/v1/usage

Returns aggregated API request counts, success rates, and latency metrics.

Query Parameters

ParameterTypeRequiredDescription
daysintegerNoLookback timeframe in days (default: 30)

Code Example (5 Languages)

curl "https://app.pingstack.in/api/v1/usage?days=30" \
  -H "Authorization: Bearer ps_secret_live_YOUR_API_KEY"

Response Example

JSON
{
  "success": true,
  "data": {
    "period_days": 30,
    "overview": {
      "total_requests": 1420,
      "successful_requests": 1410,
      "failed_requests": 10,
      "success_rate_pct": 99,
      "avg_latency_ms": 42
    }
  },
  "request_id": "req_8d9e0f1a"
}