getHistory

Returns a list of song airplay dates for a specified song.

Sample Request

<mmRequest command="getHistory" station="ID" [version="1"] [client=""] [userData=""]>
	<contents>
		<song [songId="1"] [cutId="x"] />
		[<maxHistories>10</maxHistories>]

		[<archiveHistory>1</archiveHistory>]

	</contents>
</mmRequest>

Request Notes

The song tag defines the song that you wish to retrieve histories for. You can lookup the song by its MusicMaster Song ID or it’s element ID from a third party system.

 

• songId – the MusicMaster Song ID of the element, if known.
• cutId – the element ID from the third party system.

 

Note that while songId and cutId are both listed as optional, one or the other must be included. Performance can be improved by using the MusicMaster songId for this function.

 

maxHistories – the maximum number of histories that will be returned. By default, all available active histories will be returned. These always begin with the newest history and work backward in time.

 

archiveHistory - allows this command to include archived history.

Sample Reply

<mmReply command="getHistory" station="ID" version="1" [userData=""] status="???????">
	<contents>
		<historyList>
			<history historyId="1" airdate="yyyy-mm-dd" airTime="hh:mm:ss" runtime="mm:ss" />
		</historyList>
	</contents>
</mmReply>

Compatibility and Version Info

Available with MusicMaster PRO 4.0sr18 and later