← Back to Reactor N

API Documentation

RESTful API for nuclear reactor data, fleet analytics, and public energy-market data.

Authentication

None. The public API is free and open — no key, no account, no sign-up.

curl https://reactorn.com/api/v1/reactors

All data is aggregated from public U.S. government sources (NRC, EIA, Federal Register). Please cite the primary source in published work.

Fair Use

The API is provided free for research, coursework, and personal projects. Please keep automated request rates reasonable; abusive traffic may be throttled.

Endpoints

GET /api/v1/reactors

List all 94 US commercial nuclear reactors with live NRC status.

ParamTypeDescription
statestringFilter by US state (e.g. "IL", "PA")
typestringFilter by reactor type: "PWR" or "BWR"
statusstringFilter: "online", "offline", "reduced"
// Response
{
  "reactors": [
    {
      "id": "braidwood-1",
      "name": "Braidwood Unit 1",
      "operator": "Constellation Energy",
      "type": "PWR",
      "state": "IL",
      "capacity_mw": 1178,
      "power_percent": 100,
      "status": "online",
      "nrc_last_updated": "2026-03-24T06:00:00Z"
    }
  ],
  "total": 94,
  "online": 89,
  "offline": 5
}

GET /api/v1/reactors/:id

Get detailed data for a single reactor including location, history, and license info.

GET /api/v1/reactors/:id/status

Live NRC power status, updated every 24h from NRC public data feeds.

GET /api/v1/fleet/summary

Fleet-wide metrics: total capacity, average power, outage count, capacity factor.

{
  "total_reactors": 94,
  "total_capacity_gw": 95.5,
  "fleet_capacity_factor": 0.923,
  "reactors_online": 90,
  "reactors_reduced": 3,
  "reactors_offline": 2,
  "total_generation_gwh_today": 2118.4
}

GET /api/v1/alerts

NRC regulatory alerts, enforcement actions, and Federal Register notices.

GET /api/v1/energy/forecast

AI-powered energy demand and price forecast using EIA data.

POST /api/v1/ai/chat

AI copilot for nuclear compliance, reactor analysis, and energy market insights.

// Request
{
  "message": "What is the current status of Vogtle Unit 3?",
  "context": "compliance"
}

// Response
{
  "response": "Vogtle Unit 3 is currently operating at 100% power...",
  "model": "claude-sonnet",
  "sources": ["NRC Power Status Report", "EIA Monthly"]
}

GET /api/v1/market/listings

Read-only directory of publicly announced nuclear power purchase agreements.

GET /api/v1/compliance/documents

Search NRC compliance documents, inspection reports, and regulatory filings.

POST /api/v1/simulation/run

Run scenario modeling simulations (outage impact, grid stress, demand forecasting).

// Request
{
  "scenario": "multi_reactor_outage",
  "parameters": {
    "reactors": ["braidwood-1", "byron-1"],
    "duration_days": 30
  }
}

// Response
{
  "scenario_id": "sim_abc123",
  "impact": {
    "generation_loss_gwh": 1720.4,
    "grid_stress_index": 0.82,
    "price_impact_percent": 12.3
  }
}

SDKs & Examples

Python

import requests

BASE = "https://reactorn.com/api/v1"

# Get all online reactors — no key required
reactors = requests.get(f"{BASE}/reactors?status=online").json()
print(f"{reactors['online']} reactors online")

JavaScript

const BASE = 'https://reactorn.com/api/v1';

// No key required
const res = await fetch(`${BASE}/fleet/summary`);
const fleet = await res.json();
console.log(`Fleet capacity: ${fleet.total_capacity_gw} GW`);

Ready to integrate?

No key needed — the API is free and open.

Open the App or Email API Support