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
to The end time (in epoch time) until which the data will be filtered. Max time range supported is thirty days 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 was 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 required


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
apiType API type
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