Skip to main content
​
Mar 10, 2026
Documentation
  • Reorganized documentation sidebar into three groups: Getting Started, Guides, SDK & Tools
  • Added icons to all documentation pages for easier navigation
  • New changelog page
​
Mar 5, 2026
New Feature
  • Webhook support — receive real-time push notifications for radar and signal events
  • HMAC-SHA256 signature verification on all deliveries
  • Automatic retry with exponential backoff (up to 5 attempts)
  • Auto-disable after 50 consecutive failures
  • Affected endpoints:
    • POST /v1/webhooks
    • GET /v1/webhooks
    • GET /v1/webhooks/:id
    • PATCH /v1/webhooks/:id
    • DELETE /v1/webhooks/:id
​
Feb 28, 2026
New Feature
  • CLI tool — query the Shoal API from your terminal via shoal-cli
  • Supports all endpoints: organizations, signals, radar, briefs
​
Feb 15, 2026
New FeatureDocumentation
  • New documentation guides: polling, pagination, rate limits, errors, versioning, best practices
  • SDK examples in cURL, Python, and JavaScript
​
Feb 1, 2026
Released
  • Shoal API v1 launched
  • Organization, Signal, Radar, and Brief endpoints
  • Bearer token authentication
  • Rate limiting: 100 requests/minute per key
  • Monthly credit system with usage tracking
  • Affected endpoints:
    • GET /v1/organizations/*
    • GET /v1/signal/*
    • GET /v1/radar/*
    • GET /v1/brief/*
    • GET /v1/categories/all (coming soon)
    • GET /v1/usage