Skip to content

Commit e24bbff

Browse files
bokubfabaff
authored andcommitted
Add more info about the /api/history/period route (#2699)
1 parent 204b183 commit e24bbff

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

source/developers/rest_api.markdown

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -202,6 +202,12 @@ $ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \
202202
#### {% linkable_title GET /api/history/period/<timestamp> %}
203203
Returns an array of state changes in the past. Each object contains further details for the entities.
204204

205+
The `<timestamp>` is optional and defaults to 1 day before the time of the request. It determines the beginning of the period.
206+
207+
You can pass the following optional GET parameters:
208+
- `filter_entity_id=<entity_id>` to filter on a single entity
209+
- `end_time=<timestamp>` to choose the end of the period (defaults to 1 day)
210+
205211
```json
206212
[
207213
[

0 commit comments

Comments
 (0)