---
title: "List"
method: GET
path: "/marketing/marketing-events/2026-09"
tags: ["Basic"]
---

# List

`GET /marketing/marketing-events/2026-09`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/marketing-events/2026-09`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.marketing_events.read`

Retrieve a list of marketing events for the specified API version. This endpoint supports pagination to navigate through large sets of data. Use this to access marketing event details in a paginated format.

## Query parameters

- `after` string
- `limit` integer

## Response `200`

successful operation

- CollectionResponseMarketingEventPublicReadResponseV2ForwardPaging
  - `paging` ForwardPaging: Paging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: The ID element at the start of the page
      - `link` string: Link to the next page
  - `results` MarketingEventPublicReadResponseV2[], required: An array of marketing event public read responses, each containing details about a specific marketing event.
    - `appInfo` AppInfo
      - `id` string, required: The ID of the application
      - `name` string, required: The name of the application
    - `attendees` integer: Number of attended contact records of a marketing event
    - `cancellations` integer: Number of cancelled contact records of a marketing event
    - `createdAt` string, date-time, required: The creation date and time of the marketing event
    - `customProperties` CrmPropertyWrapper[], required: An array of custom properties associated with the event.
      - `name` string, required: The name of the property in the CRM
      - `value` string, required: The value of the property in the CRM
    - `endDateTime` string, date-time: The end date and time of the marketing event
    - `eventCancelled` boolean: Indicates if the marketing event has been cancelled
    - `eventCompleted` boolean: Indicates if the marketing event has been completed
    - `eventDescription` string: The description of the marketing event
    - `eventName` string, required: The name of the marketing event
    - `eventOrganizer` string: The name of the organizer of the marketing event
    - `eventStatus` string: The status of the marketing event
    - `eventStatusV2` string: The version 2 status of the event, represented as a string.
    - `eventType` string: The type of the marketing event
    - `eventUrl` string: A URL in the external event application where the marketing event can be managed
    - `externalEventId` string: The ID that is associated with this marketing event in the external event application
    - `noShows` integer: Number of no-show contact records of a marketing event
    - `objectId` string, required: The internal ID of the marketing event in HubSpot
    - `registrants` integer: Number of registered contact records of a marketing event
    - `startDateTime` string, date-time: The start date and time of the marketing event
    - `updatedAt` string, date-time, required: The update date and time of the marketing event

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (2026-09) `e62ad9a49a20`: 2 info
  - api operation id `get-/marketing/marketing-events/2026-09_/marketing/marketing-events/2026-09` removed and replaced with `get-/marketing/marketing-events/2026-09_/marketing/marketing-events/v3`
  - the endpoint scheme security `private_apps` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/marketing-marketing-events/changes/marketing/marketing-events/2026-09/get.md)

---

[API](https://skmtc.dev/hubspot/apis/marketing-marketing-events.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-marketing-events/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-marketing-events/revisions/3afcf69ad1b4?raw)