Delete a reading by time

Developing

DELETE

https://api.enectiva.cz//import/readings/{customerId}/{importId}/{suit}

Last modified:2025-09-01 08:54:15

This endpoint allows to delete a previously created reading based on the meter identification + reading time. The time field must conform to format defined in RFC3339 and must be truncated to whole seconds to be matched.

Please, be aware that

the deletion takes some time to propagate to the GUI (it should not be longer than the import period of the meter) and

only readings created recently (last few weeks) can be deleted by this endpoint

This endpoint requires an import token, not an access token.

Request

Authorization

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://app.enectiva.cz/en/api/dashboard

Token URL: No token URL is provided. Use "Import token" from the Auth URL

Path Params

Header Params

Body Params application/json

Example

{
    "data": {
        "type": "reading_deletions",
        "attributes": {
            "time": "2025-08-25T12:00:00Z"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://api.enectiva.cz//import/readings///' \
--header 'Accept: application/vnd.api+json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data-raw '{
    "data": {
        "type": "reading_deletions",
        "attributes": {
            "time": "2025-08-25T12:00:00Z"
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "data": {
        "attributes": {
            "customer_uuid": "11e7e767-6f74-4994-b607-158ff7f7445e",
            "import_id": "40AABB_007",
            "sender": "test_script_01",
            "state": 123456.78,
            "suit": "default",
            "suspicious": false,
            "time": "2015-11-18T09:54:23+01:00",
            "unit": "kW"
        },
        "id": 1,
        "type": "readings"
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠406Not acceptable

🟠415Unsupported Media Type

🟠429Too Many Requests

🔴500Server Error

Modified at 2025-09-01 08:54:15

Delete a reading by ID

List entities