---
title: Returns a list of AuditLogs by batches (up to 100 in a single request).
canonical: https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/auditlogs/returns-a-list-of-auditlogs-by-batches--up-to-100-in-a-single-request/
product: CloudConnexa Docs
---

# Returns a list of AuditLogs by batches (up to 100 in a single request).

`GET /api/v1/audit-log`

For example:

```
Endpoint to retrieve a list of AuditLogs with filters by date range and initiatorId.
The maximum time window is 24 hours per one request
```

For example:

```
GET /api/v1/audit-log?startDate=2022-10-25T00:00:00.000Z&endDate=2022-10-26T00:00:00.000Z&size=100&initiatorId=example@example.com
```

Will return:

```json
{
  "auditLogs": [ .. ],
  "nextCursor: "63527ce1d8e5811243db4902"
}
```

If `nextCursor` is not empty, then it should be passed in the subsequent request to retrieve the next 100 auditLogs:

`GET /api/v1/audit-log?startDate=2022-10-25T00:00:00.000Z&endDate=2022-10-26T00:00:00.000Z&size=100&initiatorId=example@example.com&cursor=63527ce1d8e5811243db4902`

If you encounter rate-limit issues, retry after 1 minute. If the issue persists, please open a [Support Ticket](https://support.openvpn.com/hc/en-us/requests/new?ticket_form_id=360001597871).

```
When nextCursor is missing in the response, then there are no more auditLogs.
```

If you encounter rate-limit issues, retry after 1 minute. If the issue persists, please open a [Support Ticket](https://support.openvpn.com/hc/en-us/requests/new?ticket_form_id=360001597871).

```
When nextCursor is missing in the response, then there are no more auditLogs.
```

If you encounter rate-limit issues, retry after 1 minute. If the issue persists, please open a [Support Ticket](https://support.openvpn.com/hc/en-us/requests/new?ticket_form_id=360001597871).

`GET /api/v1/audit-log?startDate=2022-10-25T00:00:00.000Z&endDate=2022-10-26T00:00:00.000Z&size=100&initiatorId=example@example.com&cursor=63527ce1d8e5811243db4902`

If you encounter rate-limit issues, retry after 1 minute. If the issue persists, please open a [Support Ticket](https://support.openvpn.com/hc/en-us/requests/new?ticket_form_id=360001597871).

```
When nextCursor is missing in the response, then there are no more auditLogs.
```

If you encounter rate-limit issues, retry after 1 minute. If the issue persists, please open a [Support Ticket](https://support.openvpn.com/hc/en-us/requests/new?ticket_form_id=360001597871).

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| startDate | query | string(date-time) | false | Filter auditLogs by created or updated after this date (inclusive). |
| endDate | query | string(date-time) | false | Filter auditLogs by timestamp before this date (exclusive). |
| size | query | string(int32) | true | AuditLog count to return in one batch min = 1 max = 100. |
| initiatorId | query | string | false | Identifier of the user or system that initiated the configuration modification (initiatorId). Indicates who performed the action that led to the change. |
| cursor | query | string | false | An opaque string value that represents a cursor pointer for the next batch of auditLogs. |

### Detailed descriptions

```
startDate: Filter auditLogs by created or updated after this date (inclusive).
Notes: * The maximum available history duration is determined by your subscription plan.
* If the specified date is earlier than the allowed history period for your plan, an error will be returned.
* Should use ISO_INSTANT format, e.g. 2022-11-08T14:53:43Z.
* Should be less than endDate, otherwise no auditLogs will be returned.
```

**Default value : now - 1 day**

```
endDate: Filter auditLogs by timestamp before this date (exclusive).
Notes: * Should use ISO_INSTANT format, e.g. 2022-11-08T14:53:43Z.
```

```
initiatorId: Identifier of the user or system that initiated the configuration modification (initiatorId). Indicates who performed the action that led to the change.
Notes:
* For events from CloudConnexa Support initiatorId is support@openvpn.com.
* For events from CloudConnexa initiatorId is empty that’s why we can’t find by this field.
```

## Responses

| Status | Meaning | Description | Schema |
| --- | --- | --- | --- |
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [AuditLogsResponse](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/schemas/auditlogsresponse.md) |

To perform this operation, you must be authenticated by means of one of the following methods: oauth

---

Prev: [AuditLogs](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/auditlogs.md)
Next: [Schemas](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/schemas.md)
Index: https://openvpn.net/cloud-docs/llms.txt