Spec

Code snippets

curl "https://api.oanor.com/hydropower-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/hydropower-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/hydropower-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/hydropower-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "notes": "Flow in m³/s, head in m, efficiency 0–1 (default 0.85), density kg/m³ (default 1000), power in W/kW/MW, capacity factor 0–1 (default 0.5).",
        "service": "hydropower-api",
        "formulae": {
            "flow": "Q = P / (ρ·g·H·η)",
            "power": "P = ρ·g·Q·H·η",
            "annual_energy": "E = P × 8760 × capacity_factor"
        },
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/power": "Generated electrical power from flow rate, net head and efficiency.",
            "GET /v1/sizing": "Required flow (or head) to reach a target power.",
            "GET /v1/annual-energy": "Annual energy and optional revenue from power and capacity factor."
        },
        "description": "Hydroelectric power calculator: generated power from flow, head and efficiency; sizing the flow or head for a target power; and annual energy and revenue from the capacity factor."
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:34.378Z",
        "request_id": "8fafd24d-9412-424a-a96a-e7c7e0a1e9f8"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}