Download Export Audit Log Result

Purpose

To download the results of an export audit log job.

Use the link in the "download_links" JSON array key in the response GET Export Audit Log API to download the result audit log.


 

Endpoint

Request Details

Request URLs

  • To export audit log data in a ZIP file :

    {download-domain}/{version}/crm/{org_id}/auditlog/{export_audit_job_id}/{result_file}.zip

  • To export audit log data in a CSV file :

    {download-domain}/{version}/crm/{org_id}/auditlog/{export_audit_job_id}/{result_file}.csv

Scope

scope = ZohoFiles.files.READ

Downloadable File Specific Notes

  • An export audit log will be in either CSV or ZIP format, depending on the number of entries in the result. If the audit log contains 100,000 or fewer entries, the system will automatically export the logs in a CSV file. If there are more than 100,000 entries, the logs will be split into multiple CSV files inside a ZIP file, with each CSV file containing up to 100,000 entries.
  • A maximum of 10,00,000 audit entries will be exported in a ZIP file.

Sample Request to export audit log data in a ZIP format

Copiedcurl "https://download.zoho.com/v2/crm/15515278/auditlog/111111000000066005/AuditLog_1.zip"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxd"

Sample Request to export audit log data in a CSV file format

Copiedcurl "https://download.zoho.com/v2/crm/15515278/auditlog/111111000000066005/AuditLog_001.csv"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxd"

Possible Errors

  • INVALID_REQUEST_METHODHTTP 400

    The http request method type is not a valid one
    Resolution: You have specified an invalid HTTP method to access the API URL.
    Specify a valid request method. Refer to the endpoints section above.

  • OAUTH_SCOPE_MISMATCHHTTP 401

    Unauthorized
    Resolution: The client does not have a valid scope to download the export audit log data. Create a new token with valid scope. Refer to scope section above.

  • AUTHENTICATION_FAILUREHTTP 401

    Authentication failed
    Resolution: Pass the access token in the request header of the API call.

  • INVALID_URL_PATTERNHTTP 404

    Please check if the URL trying to access is a correct one
    Resolution: The request URL specified is incorrect. Specify a valid request URL. Refer to the request URL section above.

  • INTERNAL_ERRORHTTP 500

    Internal Server Error
    Resolution: Unexpected and unhandled exception in the server. Contact support team.