---
title: "List Audit Logs"
method: GET
path: "/api/v1/activity_log/audit_logs/"
tags: ["Audit Logs"]
---

# List Audit Logs

`GET /api/v1/activity_log/audit_logs/`

This endpoint retrieves a list of audit logs for the workspace, providing a comprehensive record of actions taken by users, systems, and integrations.

The audit logs can be filtered and sorted using the advanced filter and sort query parameters, which allow for complex filtering based on multiple criteria.

## Query parameters

- `filter` string
- `sort` string
- `page` integer

## Response `200`

OK

- V1ActivityLogOutPaginated
  - `results` V1ActivityLogOut[], required
    - `id` string, required
    - `parent_id` string
    - `activity_type` string, required
    - `performer_id` string
    - `performer_type` 'API' | 'AUTOMATION' | 'INTEGRATION' | 'EXTRACTION' | 'SYSTEM' | 'USER' | 'UNKNOWN' | 'MONITOR', required
    - `performer_metadata` V1ActivityLogPerformerMetadata
      - `id` string, required
      - `name` string
      - `icon` string
      - `src` string
      - `integration_type` string
      - `display_name` string
      - `disabled` boolean
      - `first_name` string
      - `last_name` string
      - `profile_picture` string
      - `is_service_account` boolean
    - `resource_id` string
    - `resource_type` 'API_KEY' | 'AUTOMATION' | 'AUTOMATION_JOB' | 'BACKGROUND_JOB' | 'COMMENT' | 'CUSTOM_PROPERTY' | 'DATABUILDER_JOB' | 'DATA_ACCESS_REQUEST' | 'IAM_ROLE' | 'IAM_RESOURCE_POLICY' | 'INCIDENT' | 'INTEGRATION' | 'INVITATION_LINK' | 'LINEAGE' | 'MARKETPLACE_INTEGRATION_SPEC' | 'MARKETPLACE_INTEGRATION_SPEC_VERSION' | 'METRIC' | 'MONITOR' | 'MONITOR_NOTIFICATION_RULE' | 'OWNER' | 'OWNER_GROUP' | 'POLICY' | 'POLICY_RESULT' | 'QUERY' | 'QUESTION' | 'QUESTION_REPLY' | 'REPORT' | 'S3_OBJECT' | 'SECODA_ENTITY' | 'SUBSCRIBER' | 'SUBSCRIBER_GROUP' | 'TAG' | 'TAG_GROUP' | 'TEAM' | 'USER' | 'USER_GROUP' | 'WIDGET' | 'WORKSPACE'
    - `resource_metadata` V1ActivityLogResourceMetadata
      - `id` string, required
      - `name` string
      - `icon` string
      - `type` string
      - `integration_id` string
    - `related_resource_ids` string[], required
    - `related_resource_type` 'API_KEY' | 'AUTOMATION' | 'AUTOMATION_JOB' | 'BACKGROUND_JOB' | 'COMMENT' | 'CUSTOM_PROPERTY' | 'DATABUILDER_JOB' | 'DATA_ACCESS_REQUEST' | 'IAM_ROLE' | 'IAM_RESOURCE_POLICY' | 'INCIDENT' | 'INTEGRATION' | 'INVITATION_LINK' | 'LINEAGE' | 'MARKETPLACE_INTEGRATION_SPEC' | 'MARKETPLACE_INTEGRATION_SPEC_VERSION' | 'METRIC' | 'MONITOR' | 'MONITOR_NOTIFICATION_RULE' | 'OWNER' | 'OWNER_GROUP' | 'POLICY' | 'POLICY_RESULT' | 'QUERY' | 'QUESTION' | 'QUESTION_REPLY' | 'REPORT' | 'S3_OBJECT' | 'SECODA_ENTITY' | 'SUBSCRIBER' | 'SUBSCRIBER_GROUP' | 'TAG' | 'TAG_GROUP' | 'TEAM' | 'USER' | 'USER_GROUP' | 'WIDGET' | 'WORKSPACE'
    - `event_blocks` V1ActivityLogEventBlock[], required
      - `type` string, required
      - `style` 'normal' | 'bold', required
      - `value` string, required
    - `logged_at` string, date-time, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `is_legacy` boolean, required
    - `version_history_id` string
    - `secoda_entity_type` string
    - `metadata` object
  - `total_pages` integer, required
  - `count` integer, required
  - `meta` V1ActivityLogPaginationMeta, required
    - `page` integer, required
    - `previous_page` integer
    - `next_page` integer
    - `count` integer, required
    - `total_pages` integer, required

---

[API](https://skmtc.dev/secoda/apis/secoda-api.md) · [All operations](https://skmtc.dev/secoda/apis/secoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/secoda/secoda-api/revisions/e6d760bd7a94/schema)