PVWATTS Web Service

PVWATTS

Click here for a complete list of operations.

GetPVWATTS

Retrieves the results of a PVWATTS simulation of a grid-connected PV system. Requires an authorization key to use.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /pvwatts.asmx HTTP/1.1
Host: pvwatts.csi-epbb.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://pvwatts.nrel.gov/GetPVWATTS"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetPVWATTS xmlns="http://pvwatts.nrel.gov">
      <key>string</key>
      <latitude>double</latitude>
      <longitude>double</longitude>
      <locationID>string</locationID>
      <DCrating>double</DCrating>
      <derate>double</derate>
      <cost>double</cost>
      <mode>int</mode>
      <tilt>double</tilt>
      <azimuth>double</azimuth>
      <inoct>double</inoct>
      <pwrdgr>double</pwrdgr>
    </GetPVWATTS>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetPVWATTSResponse xmlns="http://pvwatts.nrel.gov">
      <GetPVWATTSResult>
        <PVWATTSinfo>
          <Latitude>string</Latitude>
          <Longitude>string</Longitude>
          <Elevation>string</Elevation>
          <LocationID>string</LocationID>
          <City>string</City>
          <StateOrCountry>string</StateOrCountry>
          <Message>string</Message>
          <DCrating>string</DCrating>
          <DCtoACderate>string</DCtoACderate>
          <ACrating>string</ACrating>
          <ArrayType>string</ArrayType>
          <ArrayTilt>string</ArrayTilt>
          <ArrayAzimuth>string</ArrayAzimuth>
          <INOCT>string</INOCT>
          <PowerDegradation>string</PowerDegradation>
          <ElectricCost>string</ElectricCost>
          <Currency>string</Currency>
          <DataOrigin>string</DataOrigin>
          <Month>string</Month>
          <Solar>string</Solar>
          <ACenergy>string</ACenergy>
          <CostSaved>string</CostSaved>
          <TMYyear>string</TMYyear>
          <TMYmonth>string</TMYmonth>
          <TMYday>string</TMYday>
          <TMYhour>string</TMYhour>
          <AChourly>string</AChourly>
        </PVWATTSinfo>
        <PVWATTSinfo>
          <Latitude>string</Latitude>
          <Longitude>string</Longitude>
          <Elevation>string</Elevation>
          <LocationID>string</LocationID>
          <City>string</City>
          <StateOrCountry>string</StateOrCountry>
          <Message>string</Message>
          <DCrating>string</DCrating>
          <DCtoACderate>string</DCtoACderate>
          <ACrating>string</ACrating>
          <ArrayType>string</ArrayType>
          <ArrayTilt>string</ArrayTilt>
          <ArrayAzimuth>string</ArrayAzimuth>
          <INOCT>string</INOCT>
          <PowerDegradation>string</PowerDegradation>
          <ElectricCost>string</ElectricCost>
          <Currency>string</Currency>
          <DataOrigin>string</DataOrigin>
          <Month>string</Month>
          <Solar>string</Solar>
          <ACenergy>string</ACenergy>
          <CostSaved>string</CostSaved>
          <TMYyear>string</TMYyear>
          <TMYmonth>string</TMYmonth>
          <TMYday>string</TMYday>
          <TMYhour>string</TMYhour>
          <AChourly>string</AChourly>
        </PVWATTSinfo>
      </GetPVWATTSResult>
    </GetPVWATTSResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /pvwatts.asmx HTTP/1.1
Host: pvwatts.csi-epbb.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetPVWATTS xmlns="http://pvwatts.nrel.gov">
      <key>string</key>
      <latitude>double</latitude>
      <longitude>double</longitude>
      <locationID>string</locationID>
      <DCrating>double</DCrating>
      <derate>double</derate>
      <cost>double</cost>
      <mode>int</mode>
      <tilt>double</tilt>
      <azimuth>double</azimuth>
      <inoct>double</inoct>
      <pwrdgr>double</pwrdgr>
    </GetPVWATTS>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetPVWATTSResponse xmlns="http://pvwatts.nrel.gov">
      <GetPVWATTSResult>
        <PVWATTSinfo>
          <Latitude>string</Latitude>
          <Longitude>string</Longitude>
          <Elevation>string</Elevation>
          <LocationID>string</LocationID>
          <City>string</City>
          <StateOrCountry>string</StateOrCountry>
          <Message>string</Message>
          <DCrating>string</DCrating>
          <DCtoACderate>string</DCtoACderate>
          <ACrating>string</ACrating>
          <ArrayType>string</ArrayType>
          <ArrayTilt>string</ArrayTilt>
          <ArrayAzimuth>string</ArrayAzimuth>
          <INOCT>string</INOCT>
          <PowerDegradation>string</PowerDegradation>
          <ElectricCost>string</ElectricCost>
          <Currency>string</Currency>
          <DataOrigin>string</DataOrigin>
          <Month>string</Month>
          <Solar>string</Solar>
          <ACenergy>string</ACenergy>
          <CostSaved>string</CostSaved>
          <TMYyear>string</TMYyear>
          <TMYmonth>string</TMYmonth>
          <TMYday>string</TMYday>
          <TMYhour>string</TMYhour>
          <AChourly>string</AChourly>
        </PVWATTSinfo>
        <PVWATTSinfo>
          <Latitude>string</Latitude>
          <Longitude>string</Longitude>
          <Elevation>string</Elevation>
          <LocationID>string</LocationID>
          <City>string</City>
          <StateOrCountry>string</StateOrCountry>
          <Message>string</Message>
          <DCrating>string</DCrating>
          <DCtoACderate>string</DCtoACderate>
          <ACrating>string</ACrating>
          <ArrayType>string</ArrayType>
          <ArrayTilt>string</ArrayTilt>
          <ArrayAzimuth>string</ArrayAzimuth>
          <INOCT>string</INOCT>
          <PowerDegradation>string</PowerDegradation>
          <ElectricCost>string</ElectricCost>
          <Currency>string</Currency>
          <DataOrigin>string</DataOrigin>
          <Month>string</Month>
          <Solar>string</Solar>
          <ACenergy>string</ACenergy>
          <CostSaved>string</CostSaved>
          <TMYyear>string</TMYyear>
          <TMYmonth>string</TMYmonth>
          <TMYday>string</TMYday>
          <TMYhour>string</TMYhour>
          <AChourly>string</AChourly>
        </PVWATTSinfo>
      </GetPVWATTSResult>
    </GetPVWATTSResponse>
  </soap12:Body>
</soap12:Envelope>