Studebaker Submetering API Services

<back to all web services

GetConsumptionReport

Get the consumption report for a property
Parameters:
NameParameterData TypeRequiredDescription
PropertyIdpathintYesThe id of the property
FilterByAgeInMonthspathintNoThe age filter (defaults to 6 months)
FilterByUnitIdpathintNoFilter by this unit id (defaults to no filter)
FilterByUtilityGroupIdpathintNoFilter by this utility group id (defaults to no filter)
FilterByUtilityIdpathintNoFilter by this utility id (defaults to no filter)
IncludeVacantConsumptionpathboolNoInclude vacant consumption in results (defaults to false)

To override the Content-type in your clients HTTP Accept Header, append the .soap12 suffix or ?format=soap12

HTTP + SOAP12

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /soap12 HTTP/1.1 
Host: gallifrey.studebakersubmetering.com 
Content-Type: text/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>

<GetConsumptionReport xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSIAccountServices.Api.Consumption.Requests">
  <RequestIpAddress xmlns="http://schemas.datacontract.org/2004/07/SSIAccountServices.Api.Common.Requests">String</RequestIpAddress>
  <Token xmlns="http://schemas.datacontract.org/2004/07/SSIAccountServices.Api.Common.Requests">String</Token>
  <FilterByAgeInMonths>0</FilterByAgeInMonths>
  <FilterByUnitId>0</FilterByUnitId>
  <FilterByUtilityGroupId>0</FilterByUtilityGroupId>
  <FilterByUtilityId>0</FilterByUtilityId>
  <IncludeVacantConsumption>false</IncludeVacantConsumption>
  <PropertyId>0</PropertyId>
</GetConsumptionReport>

    </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/xml
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>

<GetConsumptionReportResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSIAccountServices.Api.Consumption.Responses">
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types" xmlns="http://schemas.datacontract.org/2004/07/SSIAccountServices.Api">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
      </d2p1:ResponseError>
    </d2p1:Errors>
  </ResponseStatus>
  <Months xmlns:d2p1="http://schemas.datacontract.org/2004/07/ABS.Interfaces">
    <d2p1:ConsumptionReportData>
      <d2p1:Consumption>
        <d2p1:ConsumptionReportDataDetail>
          <d2p1:DollarAmount>0</d2p1:DollarAmount>
          <d2p1:IsVacantConsumption>false</d2p1:IsVacantConsumption>
          <d2p1:Measure>String</d2p1:Measure>
          <d2p1:Usage>0</d2p1:Usage>
          <d2p1:UtilityGroupId>0</d2p1:UtilityGroupId>
          <d2p1:UtilityGroupName>String</d2p1:UtilityGroupName>
          <d2p1:UtilityId>0</d2p1:UtilityId>
          <d2p1:UtilityName>String</d2p1:UtilityName>
        </d2p1:ConsumptionReportDataDetail>
      </d2p1:Consumption>
      <d2p1:CycleStart>0001-01-01T00:00:00</d2p1:CycleStart>
      <d2p1:MonthName>String</d2p1:MonthName>
    </d2p1:ConsumptionReportData>
  </Months>
</GetConsumptionReportResponse>

    </soap12:Body>
</soap12:Envelope>