---
title: "Retrieve events"
method: GET
path: "/events/event-occurrences/2026-09"
tags: ["Basic"]
---

# Retrieve events

`GET /events/event-occurrences/2026-09`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/events/event-occurrences/2026-09`
- Auth: none required

Retrieve event occurrences for a specified date in September 2026. This endpoint allows you to filter and sort events based on various criteria, such as event type, object type, and occurrence dates. It supports pagination and can return specific properties of events if requested.

## Query parameters

- `after` string
- `before` string
- `eventType` string
- `id` string[]
- `limit` integer
- `objectId` integer
- `objectProperty.{propname}` object
- `objectType` string
- `occurredAfter` string, date-time
- `occurredBefore` string, date-time
- `properties` string[]
- `property.{propname}` object
- `sort` string[]

## Response `200`

successful operation

- CollectionResponseExternalUnifiedEvent
  - `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: The cursor token to pass as the after query parameter to retrieve the next page of results.
      - `link` string: The full URL of the next page of results, with the after cursor token included as a query parameter.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: The cursor token to pass as the before query parameter to retrieve the previous page of results.
      - `link` string: The full URL of the previous page of results, with the before cursor token included as a query parameter.
  - `results` ExternalUnifiedEvent[], required: An array of ExternalUnifiedEvent objects, each representing an individual event with its associated details.
    - `eventType` string, required: The format of the `eventType` string is `ae{appId}_{eventTypeLabel}`, `pe{portalId}_{eventTypeLabel}`, or just `e_{eventTypeLabel}` for HubSpot events.
    - `id` string, required: A unique identifier for the event.
    - `objectId` string, required: The objectId of the object which did the event.
    - `objectType` string, required: The objectType for the object which did the event.
    - `occurredAt` string, date-time, required: An ISO 8601 timestamp when the event occurred.
    - `properties` object, required: A key-value map of event-specific properties. The available properties depend on the event type definition.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `e212da53d814`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-09-08** (2026-09) `18c5704e0c90`: 2 info
  - the security scope `oauth-access` was added to the endpoint's security scheme `oauth2`
  - the security scope `oauth` was removed from the endpoint's security scheme `oauth2`
- **2026-09-03** (2026-09) `4bf7e603a2b0`: 2 info
  - api operation id `get-/events/event-occurrences/2026-09_/events/event-occurrences/2026-09` removed and replaced with `get-/events/event-occurrences/2026-09_/events/event-occurrences/2026-03`
  - the endpoint scheme security `private_apps` was removed from the API

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

---

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