## List

`client.V1.AuditLogs.List(ctx, query) (*CursorPage[V1AuditLogListResponse], error)`

**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

- **query:** `V1AuditLogListParams`

  - **EndingBefore:** `param.Field[Time]`

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

  - **Limit:** `param.Field[int64]`

    Max number of results that should be returned

  - **NextPage:** `param.Field[string]`

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

  - **ResourceID:** `param.Field[string]`

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

  - **ResourceType:** `param.Field[string]`

    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:** `param.Field[V1AuditLogListParamsSort]`

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

    - `V1AuditLogListParamsSort`

    - `V1AuditLogListParamsSort`

  - **StartingOn:** `param.Field[Time]`

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

### Returns

- Not supported

  - **ID:** `string`

  - **Request:** `V1AuditLogListResponseRequest`

    - **ID:** `string`

    - **IP:** `string`

    - **UserAgent:** `string`

  - **Timestamp:** `Time`

  - **Action:** `string`

  - **Actor:** `V1AuditLogListResponseActor`

    - **ID:** `string`

    - **Name:** `string`

    - **Email:** `string`

  - **Description:** `string`

  - **ResourceID:** `string`

  - **ResourceType:** `string`

  - **Status:** `V1AuditLogListResponseStatus`

    - `V1AuditLogListResponseStatus`

    - `V1AuditLogListResponseStatus`

    - `V1AuditLogListResponseStatus`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/Metronome-Industries/metronome-go"
  "github.com/Metronome-Industries/metronome-go/option"
)

func main() {
  client := metronome.NewClient(
    option.WithBearerToken("My Bearer Token"),
  )
  page, err := client.V1.AuditLogs.List(context.TODO(), metronome.V1AuditLogListParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}
```