All auditing logs are returned in a JSON format, aggregated per account, API type, user id (which accessed the API) and hour.


Method URL
GET https://{domain}/lp-auditlogapi/{accountID}?from=&to=&agentId=&api=
Example URL

URL Parameters

Name Description Type / Value Required
from The starting time (in epoch time) from which the data will be filtered. numeric required
end The end time (in epoch time) until which the data will be filtered. Max time range supported is one month numeric required
agentId If the data was accessed from Conversational Cloud's UI, this is the agentId of the user who did so. In case the data wa accessed using a historical data API, this is the AppKey used
Example: agentId=4153. To retrieve all user 4153 audit logs, use agentId=all for all.
numeric required
api History API type. Use msg_search for messaging transcripts expose, chat_search for chat transcripts expose and chat_export for chat export requests
Example: api=msg_search
string optional


JSON Example

  "recordslist": [
        "accountId": "79316966",
        "apiConsumerid": "3447834010",
        "apiType": "MSG_SEARCH",
        "time": "1560236400000",
        "interactions": [

Elements in the Response

Name Description Type / Value
accountId API user account id
apiConsumerid Agent id or AppKey of History API consumer
time Start time of data accessed in an hourly time interval
For example: 1560236400000 means the data was accessed within an interval between Tuesday, June 11, 2019 7:00:00 AM and Tuesday, June 11, 2019 7:59:59 AM
interactions List of interaction ids that were exposed to the API consumer
string array