Report a preview stream

The 2 letter ISO country code, as with our other endpoints. Should be the country where the user originated the stream from (e.g. set to US if the stream was played by a US user). Please note it can only be placed as a query string parameter, not in the POST body, or authorisation headers if those are used.

The unique identifier of the user that played that track. For information on creating users click here.

The 2 letter ISO 3166 country code, as with our other endpoints. Should be the country where the user originated the stream from (e.g. set to US if the stream was played by a US user). Please note: the query string parameter is for authorisation only and doesn't get logged, whilst the country in the body is for reporting purposes. These values can differ if you send multiple countries at once.

Either "online", "offline", or "online-cached". Indicates if the play was with an active or inactive network connection and, if the network connection is active, whether or not it was read from the device cache.

The date and time when the track was played. Should be in the ISO 8601 format.

Details of the device model and application version used to play the track. Values over 256 characters will be truncated.

Either "view" or "creation". Indicates if the play was associated to a video creation or video view. Defaults to "view" if nothing is supplied