Helioviewer Events API

Version 2.0

Welcome to the Helioviewer Events API. This API provides access to solar event data from multiple sources.

API Endpoints

Helioviewer.org Integration

• GET /helioviewer/events/{source}/observation/{timestamp}
  Legacy format for Helioviewer.org
• POST /helioviewer/events/from/{from}/to/{to}
  Events by path prefixes and time range
• POST /helioviewer/distributions/size/{size}/from/{from}/to/{to}
  Event count distribution by time buckets

Events by paths (POST): Body: {"paths": ["HEK>>Flare", "CCMC>>CME"]}, from/to (Unix timestamps)

Distribution (POST): Body: {"paths": [...]}, size (30m, h, D, W, M, Y), from/to (Unix timestamps). Returns event_types and buckets with counts per type.

Event Data

• GET /api/v1/events/recents
  Get recent events
• GET /api/v1/events/{uuid}
  Get event by UUID
• GET /api/v1/events/{uuid}/source
  Get event source data
• GET /api/v1/events/{source}/observation/{timestamp}
  Get events by observation time

Active Region Data

• GET /api/v1/regions
  Get all regions
• GET /api/v1/regions/{organization}/{external_id}
  Get events for specific region

System Information

• GET /api/v1/stats
  Get API statistics (JSON)
• GET /stats
  View statistics dashboard (HTML)

Interactive Tools

• GET /active-regions
  Search active regions (HTML)

Documentation

For more information, visit the Helioviewer website.