curl -X GET https://api3.waved.co/api/v1/data/zones/<zone_id>/live \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR-TOKEN' \
-d '{ }'
This endpoint returns live data for the zone in the venue with zone_id=<zone_id>
The data is updated every 5 minutes and is useful for understanding the current state of the zone.
It's up to the developer to use the data from the zones in a sensible way. This often requires some knowedge of the venue to know which zones are most usefull.
If you want a destilled version of the data in some form, you can use the /zones/busiest endpoint, or use the /venue/live endpoint, and look at the "representative" data - more on this in the /venue/live endpoint documentation.
{ "zone_id": "<string>", "zone_name": "<string>", "automation_is_on": "<boolean>", "timestamp": "<string>", "mood": { "index": "<number>", "tag": "<string>" }, "loudness": { "index": "<number>", "tag": "<string>" }, "vibe": { "level": "<number>", "tag": "<string>" }, "music": { "level": "<number>", "automation": "<string>", "muted": "<boolean>", "source": { "source_id": "<string>", "source_name": "<string>" } }, "error": "<string>" }