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

# Retrieve event occurrences

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

Retrieve event occurrences for the specified time frame. This endpoint allows filtering by various parameters such as object type, event type, and occurrence time. It supports pagination and sorting of results.

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

- EventsOccurrencesCollectionResponseExternalUnifiedEvent
  - `paging` Paging
    - `next` NextPage — Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required — A paging cursor token for retrieving subsequent pages.
      - `link` string — A URL that can be used to retrieve the next page results.
    - `prev` PreviousPage — specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required — A string token used to identify the position before the current page in the pagination sequence.
      - `link` string — A URL string that provides a direct link to the previous page of results.
  - `results` EventsOccurrencesExternalUnifiedEvent[], 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.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)