api/v1/data/venue/historical

This endpoint returns historical data for the venue.

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/venue/historical

cURL

curl -X GET https://api3.waved.co/api/v1/data/venue/historical \

-H 'Content-Type: application/json' \

-H 'Authorization: Bearer YOUR-TOKEN' \

-d '{ }'

About the endpoint

This endpoint returns historical data for the venue.

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

This is very useful for understanding how the venue normally behaves over time.

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

Note that when using data on a venue basis it’s important to understand that the data is an average of all zones in the venue, and that the average can be misleading if the venue has zones with very different behavior.

This is why all /venue endpoints include a "representative" index that is calculated only from the 30% - 50% (size dependent) busiest zones in the venue.

Which data type to use, venue average, venue representative or zone data, depends on the venue and the solution being created.

Return Object

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