API Documentation

Authentication

All requests require a Bearer token in the Authorization header.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://reactorn.com/api/v1/reactors

API keys are generated in Settings → API Access within the Reactor N app. Keys use the rn_live_ prefix.

Rate Limits

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Endpoints

GET /api/v1/reactors

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

Param	Type	Description
state	string	Filter by US state (e.g. "IL", "PA")
type	string	Filter by reactor type: "PWR" or "BWR"
status	string	Filter: "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/marketplace/contracts

Browse energy marketplace contracts and 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

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

headers = {"Authorization": f"Bearer {API_KEY}"}

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

JavaScript

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

const res = await fetch(`${BASE}/fleet/summary`, {
  headers: { Authorization: `Bearer ${API_KEY}` }
});
const fleet = await res.json();
console.log(`Fleet capacity: ${fleet.total_capacity_gw} GW`);

Ready to integrate?

Get your API key in the Reactor N app under Settings → API Access.

Open the App or Contact Enterprise Sales