Read and Review Automation Anywhere Documentation

Automation 360

Close Contents


Open Contents

Get Bot Insight audit trail data

  • Updated: 2021/03/11
    • Automation 360 v.x
    • Optimize
    • RPA Workspace
    • API docs

Get Bot Insight audit trail data

Retrieve information about Control Room events.


Note: View the Control Room APIs in the Community Edition, but API functionality is limited. You need a licensed Automation 360 Edition to access the full functionality of the APIs.
  • All API calls must contain an authentication token in the request header. Use the Authentication API to generate a JSON Web Token. See Authentication API.
  • You must have the AAE_Admin role or a custom role with the View everyone's audit log actions permission.

To retrieve information about Control Room events, you provide the following query parameters to the API:

Parameter Required Type Description
pageno no integer Page number from which to retrieve the data
limit no integer Specifies the number of parts in which the information is retrieved

For example, if you specify the limit as 2500 to retrieve a total of 10000 records, then the information retrieved is as follows:

  • 0 page returns 1 - 2500
  • 1st page returns 2501 - 5000
  • 2nd page returns 5001 - 7500
  • 3rd page returns 7501 - 10000
fromDate no date Start date of the period for which to retrieve the data

If you do not provide this parameter, the API will return all available data.

Format: yyyy-mm-ddThh:mm:ss

toDate no date End date of the period for which to retrieve the data.
  • Format: yyyy-mm-ddThh:mm:ss
  • Default: current date


  1. Add the authentication token to the request header.
  2. Use the GET method and endpoint URL:<control_room_URL>/v2/botinsight/data/api/getaudittraildata
  3. Send the request.
    Response body:
      "totalRecords": 10000,
      "auditTrailDataList": [
                "activityType": "BI_LOAD_DASHBOARD",
                "createdBy": 1121,
                "createdOn": "2021-01-11T11:15:06Z",
                "detail": {},
                "environmentName": "DEV",
                "eventDescription": "BI Load Dashboard",
                "hostName": "",
                "id": "AnalyticsMortgageProcessing",
                "objectName": "N/A",
                "requestId": "f36e040e-02a6-4fae-8415-9ff57067b7a3",
                "source": "Bot Insight",
                "status": "Successful",
                "userName": "ram"
    // The remaining data is omited from this code example.
    The REST API responds to each request with an HTTP response code. For response codes, see API response codes.
Send Feedback