Terabase Energy Power Plant API

Power plant design (blocks, arrays, inverters, transformers)

Operations 3

GET /Project/{projectId}/Prediction/{predictionId}/PowerPlant Get power plant #
POST /Project/{projectId}/Prediction/{predictionId}/PowerPlant Create power plant #
PUT /Project/{projectId}/Prediction/{predictionId}/PowerPlant Update power plant #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/terabase-energy-powerplant-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

terabase-energy-powerplant-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Terabase Energy Power Plant API
  version: 12.13.0
  description: 'Operations tagged PowerPlant across 2 of this provider''s published API definitions: terabase-energy-plantpredict-openapi-original.yaml, terabase-energy-powerplant-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.plantpredict.terabase.energy
  description: Production
security:
- bearerAuth: []
tags:
- name: PowerPlant
  description: Power plant design (blocks, arrays, inverters, transformers)
paths:
  /Project/{projectId}/Prediction/{predictionId}/PowerPlant:
    get:
      tags:
      - PowerPlant
      summary: Get power plant
      description: "Retrieves the power plant configuration for a prediction. Returns full PVPlant entity.\n\n**Parameters:**\n\n- `projectId` (path, required): The project ID.\n    \n- `predictionId` (path, required): The prediction ID.\n"
      operationId: getPowerPlant
      x-doc-source: postman
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: integer
      - name: predictionId
        in: path
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Power plant entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PowerPlant'
              examples:
                postman-powerplant:
                  value:
                    id: 1185523
                    resultList: null
                    blocks:
                    - name: 1
                      nodalExportOptions: null
                      resultList: null
                      arrays:
                      - name: 1
                        resultList: null
                        inverters:
                        - name: A
                          resultList: null
                          dcFields:
                          - name: 1
                            moduleId: 42930
                            module:
                              status: 3
                              model: CS6W-560TB-AG 1500V
                              manufacturer: CSI Solar Co., Ltd.
                              length: 2278
                              width: 1134
                              weight: 32.3
                              defaultOrientation: 1
                              numberOfCellsInSeries: 72
                              numberOfCellsInParallel: 2
                              stcShortCircuitCurrent: 13.69
                              stcOpenCircuitVoltage: 51.40000000001521
                              stcmppCurrent: 13.059968913682152
                              stcmppVoltage: 42.97039999999989
                              stcMaxPower: 560
                              stcPowerTempCoef: -0.2978960659351747
                              stcShortCircuitCurrentTempCoef: 0.05040175310445581
                              stcOpenCircuitVoltageTempCoef: -0.25
                              stcEfficiency: 21.724739537606087
                              minTolerance: 0
                              maxTolerance: 1.8
                              cellTechnologyType: 2
                              constructionType: 2
                              faciality: 1
                              bifacialityFactor: 80
                              transmissionFactor: 0
                              backSideMismatch: 3
                              dataSource: 1
                              lightInducedDegradation: 1.5
                              moduleQuality: 0
                              moduleMismatchCoefficient: 1
                              heatBalanceConvectiveCoef: 0
                              heatBalanceConductiveCoef: 29
                              sandiaConductiveCoef: -3.56
                              sandiaConvectiveCoef: -0.075
                              cellToModuleTempDiff: 3
                              saturationCurrentAtSTC: 1.430522027037574e-11
                              seriesResistanceAtSTC: 0.205
                              shuntResistanceAtSTC: 7500
                              diodeIdealityFactorAtSTC: 1.007220280461766
                              exponentialDependencyOnShuntResistance: 5.5
                              darkShuntResistance: 30000
                              linearTempDependenceOnGamma: -0.026929422499999824
                              shortCircuitCurrentAtSTC: 13.69
                              recombinationParameter: 0
                              builtInVoltage: 0
                              bandgapVoltage: 1.12
                              linearTempDependenceOnIsc: 0.05040175310445581
                              heatAbsorptionCoefAlphaT: 0.9
                              referenceIrradiance: 1000
                              referenceTemperature: 25
                              aGamma: null
                              bGamma: null
                              cGamma: null
                              dGamma: null
                              spectralResponse: 0
                              pvModel: 1
                              useDefaultSandiaIAM: true
                              useDefaultTabularIAM: false
                              sandiaSpectralA0: 0
                              sandiaSpectralA1: 0
                              sandiaSpectralA2: 0
                              sandiaSpectralA3: 0
                              sandiaSpectralA4: 0
                              sandiaIAMB0: 6.038242275137197
                              sandiaIAMB1: -0.5248112239136882
                              sandiaIAMB2: 0.02130703918426116
                              sandiaIAMB3: -0.00042240723312322523
                              sandiaIAMB4: 4.091960268471147e-06
                              sandiaIAMB5: -1.5564126828688897e-08
                              ashraeiamB0: 0.05
                              spectral2B0: 0.85914
                              spectral2B1: -0.02088
                              spectral2B2: -0.0058853
                              spectral2B3: 0.12029
                              spectral2B4: 0.026814
                              spectral2B5: -0.001781
                              iamFactors:
                              - id: 428902
                                incidenceAngle: 20
                                factor: 1
                              - id: 428903
                                incidenceAngle: 40
                                factor: 1
                              - id: 428904
                                incidenceAngle: 60
                                factor: 1
                              - id: 428905
                                incidenceAngle: 65
                                factor: 0.99
                              - id: 428906
                                incidenceAngle: 70
                                factor: 0.96
                              - id: 428907
                                incidenceAngle: 75
                                factor: 0.92
                              - id: 428908
                                incidenceAngle: 80
                                factor: 0.84
                              - id: 428909
                                incidenceAngle: 85
                                factor: 0.72
                              - id: 428910
                                incidenceAngle: 90
                                factor: 0
                              degradationModel: 1
                              linearDegradationRate: 0.5
                              nonLinearDegradationRates: null
                              cellDesignType: 0
                              useAntiReflectiveCoating: false
                              refractiveIndex: 1.526
                              refractiveIndexOfARC: 1.29
                              glazingExtinctionCoef: 4
                              glazingThickness: 0.002
                              powerAtSTC: 0
                              powerAtSTCExcludingWiringLosses: 0
                              effectiveIrradianceResponse: null
                              electricalShadingFractionalEffect: 100
                              moduleShadingResponse: 2
                              isMetastable: false
                              metastabilityProperties: null
                              id: 42930
                              name: CSI Solar Co., Ltd. CS6W-560TB-AG 1500V
                              description: null
                              companyId: 1042
                              company: null
                              ownerId: 4876
                              owner: null
                              createdDate: '2023-02-18T01:32:52.38'
                              lastModified: '2023-02-18T01:34:13.8666667'
                              lastModifiedById: 4876
                              lastModifiedBy: null
                            trackingType: 1
                            moduleOrientation: 1
                            irradianceOptimization: false
                            irradianceOptimizationType: 0
                            rotationSpeed: 1
                            nonIdealityFactor: 0.2
                            tablesRemovedForPCS: 0
                            transverseSlope: null
                            baselineSlope: null
                            northSouthRoadWidth: 0
                            eastWestRoadWidth: 6.096011996927617
                            modulesHigh: 1
                            modulesWide: 26
                            lateralIntermoduleGap: 0.02
                            verticalIntermoduleGap: 0.02
                            fieldLength: 358.6684981684981
                            fieldWidth: 99.09299999999999
                            collectorBandwidth: 2.278
                            tableLength: 29484.5
                            tablesPerRow: 12
                            postToPostSpacing: 5.694999999999999
                            numberOfRows: 18
                            tableToTableSpacing: 0
                            moduleAzimuth: 180
                            moduleTilt: 54
                            trackingBacktrackingType: 1
                            trackerPitchAngleD: 0
                            minimumTrackingLimitAngleD: -60
                            maximumTrackingLimitAngleD: 60
                            nightTimeStowAngleD: 0
                            trackerStowAngle: 0
                            windStowType: 0
                            arrayTechnologiesWindStowType: 0
                            windStowThreshold: null
                            windStowAngle: null
                            postHeight: 1.5
                            structureShading: 5
                            backSideMismatch: 3
                            fieldDcPower: 3134.9999999999995
                            modulesWiredInSeries: 26
                            numberOfSeriesStringsWiredInParallel: 215.31593406593404
                            plannedModuleRating: 560
                            modTempModel: 0
                            sandiaConductiveCoef: -3.56
                            sandiaConvectiveCoef: -0.075
                            cellToModuleTempDiff: 3
                            heatBalanceConductiveCoef: 29
                            heatBalanceConvectiveCoef: 0
                            nominalOperatingCellTemperature: 45
                            transmittanceAbsorptance: 0.9
                            moduleMismatchCoefficient: 1
                            moduleQuality: 0
                            lightInducedDegradation: 1.5
                            trackerLoadLoss: 2.028
                            dcWiringLossAtSTC: 1.5
                            dcHealth: 0
                            inverterIdShadeSource: null
                            monthlySeasonalTiltFactors: []
                            resultList: null
                            effectiveResistanceAtSTC: 0
                            totalModuleArea: 0
                            uiamd: null
                            uiamg: null
                            ushD: null
                            ushG: null
                            moduleSurfaceTemperatureTimeSeriesId: null
                            moduleSurfaceTemperatureTimeSeries: null
                            useModuleSurfaceTempTimeSeries: false
                            trackingAngleTimeSeriesId: null
                            trackingAngleTimeSeries: null
                            groundCoverageRatio: 40
                            calculateDCFields: false
                            shadeObjects: []
                            tableType: 0
                            shadingAlgorithm: 0
                            ground:
                              edgeOffset: 50
                              calculate: true
                              color: '#afaea4'
                              slope: 0
                              slopeAzimuth: 180
                            lockModuleAzimuth: false
                            lockModulesHigh: false
                            lockPostHeight: false
                            lockModulesWide: false
                            lockNumberOfSeriesStringsWiredInParallel: false
                            lockModulesWiredInSeries: false
                            lockPostToPostSpacing: false
                            lockMwAc: false
                            lockNumberOfRows: false
                            lockBacksideMismatch: false
                            repeater: 1
                            id: 3387869
                            description: null
                          inverterId: 3880
                          inverter:
                            status: 5
                            model: '2500'
                            manufacturer: Demo
                            powerRated: 2500
                            apparentPower: 2750
                            minDCPowerThreshold: 5000
                            minVoltage: 800
                            maxMPPVoltage: 1450
                            maxAbsoluteVoltage: 1500
                            maxCurrent: 3508
                            maxElevation: 4000
                            outputVoltage: 550
                            usekVACurves: true
                            usePQCurves: false
                            dataSource: 1
                            efficiencyCurves:
                            - id: 10567
                              voltage: 800
                              efficiencyPoints:
                              - id: 76185
                                power: 245.03
                                efficiency: 98.01
                              - id: 76186
                                power: 493.1
                                efficiency: 98.62
                              - id: 76187
                                power: 740.7
                                efficiency: 98.76
                              - id: 76188
                                power: 1234.63
                                efficiency: 98.77
                              - id: 76189
                                power: 1849.69
                                efficiency: 98.65
                              - id: 76190
                                power: 2461.25
                                efficiency: 98.45
                            - id: 10568
                              voltage: 900
                              efficiencyPoints:
                              - id: 76191
                                power: 244.6
                                efficiency: 97.84
                              - id: 76192
                                power: 492.35
                                efficiency: 98.47
                              - id: 76193
                                power: 739.73
                                efficiency: 98.63
                              - id: 76194
                                power: 1233.13
                                efficiency: 98.65
                              - id: 76195
                                power: 1847.06
                                efficiency: 98.51
                              - id: 76196
                                power: 2457.75
                                efficiency: 98.31
                            - id: 10569
                              voltage: 1200
                              efficiencyPoints:
                              - id: 76197
                                power: 243.48
                                efficiency: 97.39
                              - id: 76198
                                power: 491
                                efficiency: 98.2
                              - id: 76199
                                power: 738.08
                                efficiency: 98.41
                              - id: 76200
                                power: 1230.75
                                efficiency: 98.46
                              - id: 76201
                                power: 1842.56
                                efficiency: 98.27
                              - id: 76202
                                power: 2454.75
                                efficiency: 98.19
                            kVACurves:
                            - id: 3872
                              elevation: 2000
                              kVAPoints:
                              - id: 21335
                                temperature: -35
                                kVA: 2750
                              - id: 21336
                                temperature: 45
                                kVA: 2750
                              - id: 21337
                                temperature: 50
                                kVA: 2500
                              - id: 21338
                                temperature: 60
                                kVA: 0
                            - id: 3873
                              elevation: 3000
                              kVAPoints:
                              - id: 21339
                                temperature: -35
                                kVA: 2250
                              - id: 21340
                                temperature: 45
                                kVA: 2250
                              - id: 21341
                                temperature: 50
                                kVA: 2025
                              - id: 21342
                                temperature: 60
                                kVA: 0
                            - id: 3874
                              elevation: 4000
                              kVAPoints:
                              - id: 21343
                                temperature: -35
                                kVA: 1750
                              - id: 21344
                                temperature: 45
                                kVA: 1750
                              - id: 21345
                                temperature: 50
                                kVA: 1575
                              - id: 21346
                                temperature: 60
                                kVA: 0
                            pqCurves: null
                            inverterType: 2
                            id: 3880
                            name: 'Demo Central 2500 '
                            description: copied for presentation on sep 2020
                            companyId: 1
                            company: null
                            ownerId: 742
                            owner: null
                            createdDate: '2020-09-09T20:28:25.8833333'
                            lastModified: '2020-09-15T18:28:12.46'
                            lastModifiedById: 742
                            lastModifiedBy: null
                          setpointkW: 2612.5
                          powerFactor: 0.95
                          designDerate: 0.95
                          kVARating: 2750
                          totalModuleArea: 0
                          derateTimeSeriesId: null
                          derateTimeSeries: null
                          useDerateTimeSeries: false
                          setPointTimeSeriesId: null
                          setPointTimeSeries: null
                          useSetPointTimeSeries: false
                          vmppAdjustmentTimeSeriesId: null
                          vmppAdjustmentTimeSeries: null
                          useVMPPTimeSeriesAdjustment: false
                          imppAdjustmentTimeSeriesId: null
                          imppAdjustmentTimeSeries: null
                          useIMPPTimeSeriesAdjustment: false
                          repeater: 1
                          id: 2975697
                          description: null
                        acCollectionLoss: 1
                        dasLoad: 800
                        coolingLoad: 0
                        additionalLosses: 0
                        matchTotalInverterkVA: true
                        transformerEnabled: true
                        transformerkVARating: 2750
                        transformerHighSideVoltage: 34.5
                        transformerNoLoadLoss: 0.2
                        transformerFullLoadLoss: 0.7
                        totalModules: 0
                        totalModuleArea: 0
                        trackerMotorLosses: 0
                        repeater: 1
                        id: 2720072
                        description: null
                      energizationDate: null
                      useEnergizationDate: false
                      numberOfModules: 0
                      totalModuleArea: 0
                      repeater: 1
                      id: 1538513
                      description: null
                    transformers: []
                    transmissionLines: []
                    ess: null
                    esS_Id: null
                    exportSystem: false
                    exportESS: false
                    lgiaLimitTimeSeriesId: null
                    lgiaLimitTimeSeries: null
                    useLGIALimitTimeSeries: false
                    powerFactor: 0.95
                    lgiaLimitation: null
                    nighttimeDisconnect: false
                    availabilityLoss: null
                    useCoolingTemp: true
                    desiredDCACRatio: null
                    powerPlantDesignType: 0
                    customArrayConfig: null
                    useCustomArrayConfig: false
                    totalModuleArea: 0
                    maxMVTransformerVoltage: 0
                    maximumPlantOutput: 0
        '204':
          description: No power plant has been created for this prediction yet. Response body is empty.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
    post:
      tags:
      - PowerPlant
      summary: Create power plant
      description: "Creates a power plant for a prediction. May attach X-Message header with configuration warnings.\n\n**Parameters:**\n\n- `projectId` (path, required): The project ID.\n    \n- `predictionId` (path, required): The prediction ID.\n    \n- `powerPlant` (body, required): The PVPlant entity to create.\n"
      operationId: createPowerPlant
      x-doc-source: postman
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: integer
      - name: predictionId
        in: path
        required: true
        schema:
          type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PowerPlant'
            examples:
              postman-projects-powerplant-powerplant:
                value:
                  blocks:
                  - name: 1
                    nodalExportOptions:
                      id: 103584
                      exportBlock: false
                      exportArrays: false
                      exportInverters: false
                      exportDCFields: true
                    resultList: null
                    arrays:
                    - name: 1
                      resultList: null
                      inverters:
                      - name: A
                        resultList: null
                        dcFields:
                        - name: 1
                          moduleId: 40014
                          module:
                            status: 5
                            model: FS-7505A-TR1 September2022
                            manufacturer: First Solar
                            length: 2300
                            width: 1215
                            weight: 39.7
                            defaultOrientation: 1
                            numberOfCellsInSeries: 268
                            numberOfCellsInParallel: 1
                            stcShortCircuitCurrent: 3.013
                            stcOpenCircuitVoltage: 223.931
                            stcmppCurrent: 2.767
                            stcmppVoltage: 182.47
                            stcMaxPower: 505
                            stcPowerTempCoef: -0.32
                            stcShortCircuitCurrentTempCoef: 0.04
                            stcOpenCircuitVoltageTempCoef: -0.28
                            stcEfficiency: 18.071211307926283
                            minTolerance: 0
                            maxTolerance: 5
                            cellTechnologyType: 6
                            constructionType: 1
                            faciality: 0
                            bifacialityFactor: null
                            transmissionFactor: null
                            backSideMismatch: null
                            dataSource: 1
                            lightInducedDegradation: 0
                            moduleQuality: 0
                            moduleMismatchCoefficient: 0.5
                            heatBalanceConvectiveCoef: 0
                            heatBalanceConductiveCoef: 29
                            sandiaConductiveCoef: -3.47
                            sandiaConvectiveCoef: -0.0594
                            cellToModuleTempDiff: 3
                            saturationCurrentAtSTC: 4.91147e-10
                            seriesResistanceAtSTC: 3.885
                            shuntResistanceAtSTC: 11500
                            diodeIdealityFactorAtSTC: 1.452
                            exponentialDependencyOnShuntResistance: 5.5
                            darkShuntResistance: 12000
                            linearTempDependenceOnGamma: 0.01584022038567493
                            shortCircuitCurrentAtSTC: 3.013
                            recombinationParameter: 2.15
                            builtInVoltage: 0.9
                            bandgapVoltage: 1.5
                            linearTempDependenceOnIsc: 0.04
                            heatAbsorptionCoefAlphaT: 0.9
                            referenceIrradiance: 1000
                            referenceTemperature: 25
                            aGamma: null
                            bGamma: null
                            cGamma: null
                            dGamma: null
                            spectralResponse: 2
                            pvModel: 0
                            useDefaultSandiaIAM: false
                            useDefaultTabularIAM: false
                            sandiaSpectralA0: null
                            sandiaSpectralA1: null
                            sandiaSpectralA2: null
                            sandiaSpectralA3: null
                            sandiaSpectralA4: null
                            sandiaIAMB0: 6.038242275137197
                            sandiaIAMB1: -0.5248112239136882
                            sandiaIAMB2: 0.02130703918426116
                            sandiaIAMB3: -0.00042240723312322523
                            sandiaIAMB4: 4.091960268471147e-06
                            sandiaIAMB5: -1.5564126828688897e-08
                            ashraeiamB0: 0.05
                            spectral2B0: 0.86273
                            spectral2B1: -0.038948
                            spectral2B2: -0.012506
                            spectral2B3: 0.098871
                            spectral2B4: 0.084658
                            spectral2B5: -0.0042948
                            iamFactors: null
                            degradationModel: 1
                            linearDegradationRate: 0.3
                            nonLinearDegradationRates: null
                            cellDesignType: null
                            powerAtSTC: 0
                            powerAtSTCExcludingWiringLosses: 0
                            effectiveIrradianceResponse: null
                            electricalShadingFractionalEffect: 0
                            moduleShadingResponse: 1
                            id: 40014
                            name: FS-7505A-TR1 CdTe September2022
                            description: S7_505_540
                          trackingType: 1
                          moduleOrientation: 1
                          irradianceOptimization: true
                          rotationSpeed: 1
                          nonIdealityFactor: 0.2
                          tablesRemovedForPCS: 0
                          transverseSlope: null
                          baselineSlope: null
                          northSouthRoadWidth: 6.096011996927617
                          eastWestRoadWidth: 6.096011996927617
                          modulesHigh: 1
                          modulesWide: 6
                          lateralIntermoduleGap: 0.02
                          verticalIntermoduleGap: 0.02
                          fieldLength: 54.876237623762385
                          fieldWidth: 42.54999999999999
                          collectorBandwidth: 2.3
                          tableLength: 7290.1
                          tablesPerRow: 8
                          postToPostSpacing: 5.749999999999999
                          numberOfRows: 8
                          tableToTableSpacing: 0
                          moduleAzimuth: 180
                          moduleTilt: 45
                          trackingBacktrackingType: 0
                          trackerPitchAngleD: 0
                          minimumTrackingLimitAngleD: -60
                          maximumTrackingLimitAngleD: 60
                          trackerStowAngle: 0
                          postHeight: 1.5
                          structureShading: 5
                          backSideMismatch: null
                          fieldDcPower: 180
                          modulesWiredInSeries: 6
                          numberOfSeriesStringsWiredInParallel: 59.40594059405941
                          plannedModuleRating: 505
                          modTempModel: 0
                          sandiaConductiveCoef: -3.47
                          sandiaConvectiveCoef: -0.0594
                          cellToModuleTempDiff: 3
                          heatBalanceConductiveCoef: 29
                          heatBalanceConvectiveCoef: 0
                          nominalOperatingCellTemperature: 45
                          transmittanceAbsorptance: 0.9
                          moduleMismatchCoefficient: 0.5
                          moduleQuality: 0
                          lightInducedDegradation: 0
                          trackerLoadLoss: 2.028
                          dcWiringLossAtSTC: 1.5
                          dcHealth: 1
                          monthlySeasonalTiltFactors: []
                          resultList: null
                          effectiveResistanceAtSTC: 0
                          totalModuleArea: 0
                          uiamd: null
                          uiamg: null
                          ushD: null
           

# --- truncated at 32 KB (68 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/terabase-energy/refs/heads/main/openapi/terabase-energy-powerplant-api-openapi.yml