---
title: "GET /cms/audit-logs/v3"
method: GET
path: "/cms/audit-logs/v3"
tags: ["Basic"]
---

# GET /cms/audit-logs/v3

`GET /cms/audit-logs/v3`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/audit-logs/v3`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `content`

## Query parameters

- `after` string
- `before` string
- `eventType` string[]
- `limit` integer
- `objectId` string[]
- `objectType` string[]
- `sort` string[]
- `userId` string[]

## Response `200`

successful operation

- CollectionResponsePublicAuditLog
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: Cursor token representing the boundary timestamp after which to fetch the next page of results. Pass this value as the after query parameter to retrieve later audit logs.
      - `link` string: Pre-constructed URL that can be used to directly fetch the next page of results without manually building the query.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: Pre-constructed URL that can be used to directly fetch the previous page of results without manually building the query.
      - `link` string: Cursor token representing the boundary timestamp before which to fetch the previous page of results. Pass this value as the before query parameter to retrieve earlier audit logs.
  - `results` PublicAuditLog[], required
    - `event` 'CREATED' | 'DELETED' | 'PUBLISHED' | 'RESTORE' | 'UNPUBLISHED' | 'UPDATED', required: The type of event that took place (CREATED, UPDATED, PUBLISHED, DELETED, UNPUBLISHED).
    - `fullName` string, required: The name of the user who caused the event.
    - `meta` object, required: Supplementary metadata associated with the audit log entry. It provides additional context about the audited event (ex: rows deleted/updated for a HubDB event, the specific fields that were changed for a Content Settings event).
    - `objectId` string, required: The ID of the object.
    - `objectName` string, required: The internal name of the object in HubSpot.
    - `objectType` 'BLOG' | 'BLOG_POST' | 'CASE_STUDY' | 'CONTENT_SETTINGS' | 'CSS' | 'CTA' | 'DOMAIN' | 'EMAIL' | 'FILE' | 'GLOBAL_MODULE' | 'HUBDB_TABLE' | 'JS' | 'KNOWLEDGE_BASE' | 'KNOWLEDGE_BASE_ARTICLE' | 'LANDING_PAGE' | 'MODULE' | 'PODCAST' | 'QUOTE' | 'SERVERLESS_FUNCTION' | 'TEMPLATE' | 'THEME' | 'URL_MAPPING' | 'WEB_INTERACTIVE' | 'WEBSITE_PAGE', required: The type of the object (BLOG, LANDING_PAGE, DOMAIN, HUBDB_TABLE etc.)
    - `timestamp` string, date-time, required: The timestamp at which the event occurred.
    - `userId` string, required: The ID of the user who caused the event.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (v3) `fabf189fcc9c`: 1 info
  - endpoint added
- **2026-07-13** (v3) `a6963549c4ed`: 1 breaking
  - api path removed without deprecation
- **2026-05-22** (v3) `d050c0f63d27`: 2 info
  - the security scope `content` was added to the endpoint's security scheme `oauth2`
  - the security scope `cms-audit-logs-read` was removed from the endpoint's security scheme `oauth2`
- **2026-04-15** (v3) `fac932192cd8`: 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
- **2026-04-12** (v3) `8e62f6399621`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/cms-cms-content-audit/changes/cms/audit-logs/v3/get.md)

---

[API](https://skmtc.dev/hubspot/apis/cms-cms-content-audit.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-cms-content-audit/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-cms-content-audit/revisions/37658b57b36e?raw)