---
title: Get Audit Events
framework: Apple Business API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple business api 2.5+]
path: applebusinessapi/get-audit-events
---

# Get Audit Events

Get a list of audit events in an organization that satisfies the query criteria.

## URL

GET https://api-business.apple.com/v1/auditEvents

## Query Parameters

filter[startTimestamp]: ISO8601 formatted start timestamp of query time range. filter[endTimestamp]: ISO8601 formatted end timestamp of query time range. filter[actorId]: Id of actor of event. Note that only one actor id in query is supported. filter[subjectId]: Id of subject of event. Note that only one subject id in query is supported. filter[type]: Type of event. Note that only one type in query is supported. limit: The number of included related resources to return. fields[auditEvents]: cursor:

## Response Codes

200 OK: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 429 : Too Many Requests

## Example

Example

## Topics

### Responses

- [AuditEventsResponse](applebusinessapi/auditeventsresponse.md)
