Web Service Documentation / Categories / Meter Services / Delete Waste Data

Delete Waste Data

Updated on June 28, 2021

Description

This web service deletes waste data from a specified meter based on a specified optional date range. The meter must already be shared to you and you must have read write access. This web service only supports waste meters. Deleting the waste data is permanent and cannot be undone.

NOTE: If you misspell the "startDate" or "endDate" parameter then the resulting behavior is equivalent to if the parameter was omitted. For example, if you run this web service and misspelled both date range parameters then all of the waste data for that meter will be deleted which is the default behavior.

Version

23.0

HTTP Method

DELETE

Resource URL

/meter/(meterId)/wasteData?startDate=(YYYY-MM-DD)&endDate=(YYYY-MM-DD)

Header

Field Name Value Comments
Authorization Basic credentials

Authorization Required

Yes

Parameters

Parameter Name Description
endDate Optional. Indicates the end date of a custom date range to delete waste data. Must be a valid date formatted as YYYY-MM-DD.
meterId Id to the meter
startDate Optional. Indicates the start date of a custom date range to delete waste data. Must be a valid date formatted as YYYY-MM-DD.

XML Schemas

Request/Response Schema Name
Request None
Response response.xsd

Example Requests

The following example deletes all waste data from the meter that has an id of 501.

DELETE  /meter/501/wasteData

The following example deletes waste data from the meter that has an id of 500 that covers a date range of January 1st, 2011 to December 31st.

DELETE  /meter/501/wasteData?startDate=2011-01-01&endDate=2011-12-31

Example Response

The following example indicates that the waste data was successfully deleted from the meter that has an id of 501.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok"/>
LIVE