Retrieves tenant audit events formatted in HP ArcSight Common Event Format (CEF) text stream, designed for direct ingestion into enterprise SIEM log forwarders.
To receive CEF logs instead of JSON, client requests must specify Accept: text/plain in the HTTP request headers. The returned payload contains newline-delimited CEF records adhering to the standard schema: CEF:0|Anaplan, Inc.|Host|Version|SignatureID|Name|Severity|Extension. Extensions include key-value pairs for id, userId, tenantId, createdDate, ipAddress, userAgent, and checksum. Time filtering and pagination query parameters operate identically to the JSON endpoint.
Ensure your SIEM receiver or syslog forwarder parser is configured to map Anaplan CEF extension fields such as eventDate, checksum, and objectTenantId.
Method and endpoint
/audit/api/1/events
Parameters
| Parameter | Type | Required/optional | Description |
type | String | Optional | Event category filter: all (default), byok, or user_activity. |
intervalInHours | Integer | Optional | Relative lookback window in hours from current time (for example, 24, 168). |
dateFrom | Long integer | Optional | Start time boundary timestamp in milliseconds UTC. |
dateTo | Long integer | Optional | End time boundary timestamp in milliseconds UTC. |
limit | Integer | Optional | Maximum results to return per page (default is 20, maximum is 10000). |
Curl example
curl -X GET "https://audit.anaplan.com/audit/api/1/events?type=all&intervalInHours=24" \
-H "Authorization: AnaplanAuthToken {anaplan_auth_token}" \
-H "Accept: text/plain"
Response
Success response
If the request is successful, the API returns an HTTP 200 OK status code with Content-Type: text/plain containing newline-separated CEF formatted log strings.
| HTTP status | Status message | Description |
200 | OK (text/plain) | CEF search results returned successfully. |
Example successful response body
2018-03-12T19:12:50.000Z CEF:0|Anaplan, Inc.|||USR-1|User created|id=973275641490563072 userId=8a80d86a5565443f01557f053e6719ba tenantId=8a80d8034e9a6fa0014e9aa747ae0002 eventTimeZone=UTC createdDate=1520881970000 createdTimeZone=UTC success=true ipAddress=10.1.101.127 userAgent=Mozilla/5.0 checksum=a80bffa2ecfd3e87f81237345735567e135de70884c37b5aa6b58d01bb4a9430
Failure response
If the request is unsuccessful, the API returns an error code.
| HTTP status | Error message | Description/resolution |
401 | Unauthorized | Invalid or expired authentication token. Re-authenticate with the Anaplan Authentication Service. |
403 | Forbidden | User lacks the Tenant Auditor role required to access the tenant audit logs. |
Example error response body
{
"status": "FAILURE",
"statusMessage": "Unauthorized request"
}