## List

`v1.audit_logs.list(AuditLogListParams**kwargs)  -> SyncCursorPage[AuditLogListResponse]`

**get** `/v1/auditLogs`

Retrieves a range of audit logs. If no further audit logs are currently available, the data array will be empty. As new audit logs are created, subsequent requests using the same next_page value will be in the returned data array, ensuring a continuous and uninterrupted reading of audit logs.

### Parameters

- **ending\_before:** `Union[str, datetime]`

  RFC 3339 timestamp (exclusive). Cannot be used with 'next_page'.

- **limit:** `int`

  Max number of results that should be returned

- **next\_page:** `str`

  Cursor that indicates where the next page of results should start.

- **resource\_id:** `str`

  Optional parameter that can be used to filter which audit logs are returned. If you specify resource_id, you must also specify resource_type.

- **resource\_type:** `str`

  Optional parameter that can be used to filter which audit logs are returned. If you specify resource_type, you must also specify resource_id.

- **sort:** `Literal["date_asc", "date_desc"]`

  Sort order by timestamp, e.g. date_asc or date_desc. Defaults to date_asc.

  - `"date_asc"`

  - `"date_desc"`

- **starting\_on:** `Union[str, datetime]`

  RFC 3339 timestamp of the earliest audit log to return. Cannot be used with 'next_page'.

### Returns

- `class AuditLogListResponse`

  - **id:** `str`

  - **request:** `Request`

    - **id:** `str`

    - **ip:** `Optional[str]`

    - **user\_agent:** `Optional[str]`

  - **timestamp:** `datetime`

  - **action:** `Optional[str]`

  - **actor:** `Optional[Actor]`

    - **id:** `str`

    - **name:** `str`

    - **email:** `Optional[str]`

  - **description:** `Optional[str]`

  - **resource\_id:** `Optional[str]`

  - **resource\_type:** `Optional[str]`

  - **status:** `Optional[Literal["success", "failure", "pending"]]`

    - `"success"`

    - `"failure"`

    - `"pending"`

### Example

```python
from metronome import Metronome

client = Metronome(
    bearer_token="My Bearer Token",
)
page = client.v1.audit_logs.list()
page = page.data[0]
print(page.id)
```