Browse developer

Endpoint reference

GET

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

This endpoint returns historical data for the zone in the venue with zone_id=<zone_id>

Base URLhttps://api3.waved.co
AuthenticationBearer token
Contract review required

The full migrated endpoint description and response example are preserved below. They must be checked against the authoritative API contract before publication.

Migrated reference

The complete public source content is preserved below. Examples still require technical verification before launch.

GET :

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

cURL

curl -X GET https://api3.waved.co/api/v1/data/zones/<zone_id>/historical \ 
-H 'Content-Type: application/json' \ 
-H 'Authorization: Bearer YOUR-TOKEN' \ 
-d '{ }'

About the endpoint

This endpoint returns historical data for the zone in the venue with zone_id=<zone_id>

The data is updated every week and is returned in 30-minute intervals

This is very useful for understanding how a zone normally behaves over time.

It's up to the developer to use the data from the zones in a sensible way and comparing live data and how it’s trending to historical data can be very powerful when creating autonomous solutions.

The data returned shows how the movement of the mood index and loudness index typically varies throughout each day of the week.

Return Object

{
  "zone_id": "<string>",
  "zone_name": "<string>",
  "monday": {
    "mood": "<number[]>",
    "loudness": "<number[]>"
  },
  "tuesday": {
    "mood": "<number[]>",
    "loudness": "<number[]>"
  },
  "wednesday": {
    "mood": "<number[]>",
    "loudness": "<number[]>"
  },
  "thursday": {
    "mood": "<number[]>",
    "loudness": "<number[]>"
  },
  "friday": {
    "mood": "<number[]>",
    "loudness": "<number[]>"
  },
  "saturday": {
    "mood": "<number[]>",
    "loudness": "<number[]>"
  },
  "sunday": {
    "mood": "<number[]>",
    "loudness": "<number[]>"
  },
  "time": {
    "utc0": "<string[]>"
  }
}