API Documentation

Programmatic access to your PingSage monitoring data. All endpoints return JSON.

Authentication

Include your API key or a scoped token in the Authorization header:

Authorization: Bearer mont_y...pre>
  
You can find your personal API key in the Settings → API Keys section of your dashboard. Generate scoped tokens there as well for specific integrations.

  
 Sites

  

    GET /api/sites
    
List your monitored sites with 24h uptime
  

  

    GET /api/sites/all
    
List all visible sites (personal + team sites) with domain expiry, SSL, and uptime
  

  

    POST /api/sites
    
Add a new site to monitor
  
  
Request body:
  
namestringHuman-readable name
  
urlstringFull URL (https://example.com)
  
check_intervalintMinutes between checks (default: 5)
  
ssl_checkboolEnable SSL certificate checking (default: true)

  

    GET /api/sites/{id}
    
Get detailed info for a specific site, including recent checks and uptime stats
  

  

    GET /api/sites/{id}/checks
    
Get last 200 check results for a site
  

  

    GET /api/sites/{id}/history
    
Get uptime history (24h/7d/30d) + downtime events for the last 7 days
  

  

    DELETE /api/sites/{id}
    
Remove a site from monitoring
  

  
 Security & SSL

  

    GET /api/security
    
Get latest security header grades for all your sites (HSTS, CSP, XFO, X-CTO, RP)
  

  

    POST /api/security/check
    
Trigger a security header re-check for all your sites
  

  

    GET /api/ssl
    
Get latest SSL certificate status for all your HTTPS sites
  

  

    POST /api/ssl/check
    
Trigger an SSL certificate re-check for all your HTTPS sites
  

  
 Broken Links

  

    GET /api/broken-links
    
Get latest broken link scan results for all your sites
  

  

    POST /api/broken-links/check
    
Trigger a broken link scan for all your sites
  

  
 Performance

  

    GET /api/performance/{site_id}
    
Get response time history (last 500 checks) for a site
  

  
 Content Monitoring

  

    GET /api/content-monitors
    
List all your content change monitors
  

  

    POST /api/content-monitors
    
Add a URL to monitor for content changes
  

  

    POST /api/content-monitors/{id}/check
    
Check if a monitored URL has changed
  

  

    DELETE /api/content-monitors/{id}
    
Remove a content monitor
  

  
 Team

  

    POST /api/invite
    
Invite a user (by email) to share your monitoring
  

  

    GET /api/team/members
    
List team members
  

  
 Status Pages

  

    GET /api/status/config
    
Get your status page configuration
  

  

    POST /api/status/config
    
Enable/disable your public status page
  

  
 Alerts

  

    GET /api/alerts/contacts
    
List your configured alert channels
  

  

    POST /api/alerts/contacts
    
Add an alert channel (email, slack, discord, webhook, etc.)
  

  
 Token Management

  

    GET /api/tokens
    
List your API tokens
  

  

    POST /api/tokens
    
Create a new API token
  

  

    DELETE /api/tokens/{id}
    
Revoke an API token
  

  
 Example: cURL
  
# List your sites
curl -H "Authorization: Bearer *** https://pingsage.com/api/sites/all

# Check a site's history
curl -H "Authorization: Bearer *** https://pingsage.com/api/sites/1/history

# Add a new site
curl -X POST -H "Authorization: Bearer *** \
  -H "Content-Type: application/json" \
  -d '{"name":"My Site","url":"https://example.com"}' \
  https://pingsage.com/api/sites

# Trigger SSL re-check
curl -X POST -H "Authorization: Bearer *** \
  https://pingsage.com/api/ssl/check

  

    Open Dashboard 
    
Generate your API key in Settings → API Keys