chats.details

This function retrieves a list of chat message logs for the given roomid.

Parameters

string	api_key	(required) your api key
string	roomid	(required) the roomid of the room to fetch logged chat messages for
integer	start	(optional) the start index of records to return. Default: 0
integer	length	(optional) the number of records to return, start at start above. Default: 250

Sample return XML
Returns the chat logs ordered by date, newest first.
<?xml version="1.0" encoding="UTF-8"?> <response function="chats.details" status="ok"> <result_set totalResults="21"> <result> <roomid>k3ns5</roomid> <msg><![CDATA[guest: are you guyes there?]]></msg> <added>2009-05-30 06:19:29.0</added> </result> <result> <roomid>k3ns5</roomid> <msg><![CDATA[guest: hello]]></msg> <added>2009-05-30 06:19:16.0</added> </result> </result_set> </response>

Result explanation

string	roomid	globally unique identifier for this room
string	msg	The actual chat message with HTML formatting as sent by the user.
datetime	added	the date and time (GMT, London time) when this message was sent and logged

Error Response
If the function call does not succeed it returns the following error response.

An example of an error response would be the following <?xml version="1.0" encoding="UTF-8"?> <response function="chats.details" status="fail"> <error code="400" message="unknown roomid"/> </response>