TurbineHub API Reference

Project Details

GET /v1/projects

Retrieves details for wind, solar, and battery projects including financials and generation data.

Attributes:

  • projectName (string): Name of the project.

  • averageLatitude (double): Latitude coordinate.

  • averageLongitude (double): Longitude coordinate.

  • balancingAuthority (string): Associated balancing authorities.

  • county (string): County where the project is located.

  • state (string): State abbreviation.

  • mwTotalCapacity (double): Total project capacity in megawatts.

  • mwOnlineCapacity (double): Online project capacity.

  • status (string): Project status (Online, Under Construction, Advanced Development).

  • manufacturer (string): Equipment manufacturer.

  • model (string): Equipment model.

  • nercRegion (string): NERC region of the project.

  • owner (string): Project owner.

  • ppaRate (double): Rate of power purchase agreement.

  • yearsOnline (double): Duration project has been online.

  • lifetimeNetCapacityFactor (double): Lifetime net capacity factor.

  • generationMWh (double): Net generation in MWh.

Request Example:

curl -X GET "https://api.turbinehub.com/v1/projects" -H "Authorization: Bearer YOUR_API_KEY"

Response Example:

{
  "projectName": "Blue Canyon Wind Farm",
  "averageLatitude": 34.8,
  "averageLongitude": -98.6,
  "balancingAuthority": "SPP",
  "county": "Caddo",
  "state": "OK",
  "mwTotalCapacity": 324,
  "mwOnlineCapacity": 324,
  "status": "Online",
  "manufacturer": "GE",
  "model": "GE 2.5-116",
  "nercRegion": "SPP",
  "owner": "NextEra Energy Resources",
  "ppaRate": 25.00,
  "yearsOnline": 15,
  "lifetimeNetCapacityFactor": 0.36,
  "generationMWh": 852000
}

Turbine List

GET /v1/turbines

Retrieves details for turbines including technical specifications and operational data.

Attributes:

  • hubHeight (double): Height of the turbine hub in meters.

  • rotorDiameter (double): Rotor diameter in meters.

  • manufacturer (string): Turbine manufacturer.

  • model (string): Turbine model.

  • totalHeight (double): Total height of the turbine in meters.

  • capacityMW (double): Nameplate capacity in megawatts.

Request Example:

curl -X GET "https://api.turbinehub.com/v1/turbines" -H "Authorization: Bearer YOUR_API_KEY"

Response Example:

{
  "hubHeight": 80,
  "rotorDiameter": 116,
  "manufacturer": "GE",
  "model": "GE 2.5-116",
  "totalHeight": 138,
  "capacityMW": 2.5
}

Capacity Factor Data

GET /v1/capacity-factor

Retrieves historical capacity factor data.

Attributes:

  • timePeriod (string): Time period for capacity factor calculation (lifetime, 48-month, etc.).

  • capacityFactor (double): Calculated capacity factor.

  • generationMWh (double): Generation in megawatt-hours.

Request Example:

curl -X GET "https://api.turbinehub.com/v1/capacity-factor?period=lifetime" -H "Authorization: Bearer YOUR_API_KEY"

Response Example:

{
  "timePeriod": "lifetime",
  "capacityFactor": 0.38,
  "generationMWh": 1500000
}

(Replace YOUR_API_KEY with your actual API token provided by TurbineHub.)