header.banner.text
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
22.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"/>
