Waved APIDevelopers API

GET :

api/v1/data/zones/<zone_id>/live

cURL

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 '{ }'

About the endpoint

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.

Return Object

{
  "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>"
}