There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Get a Group of Events by ID

Last updated May 15, 2023

GET /reports/v2/events/batch

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


Given a batch of event IDs, returns a list of event definitions in a given portal. Events can be created in-app, or dynamically via the Tracking Code API

Note: Access to the data from this endpoint will require a Marketing Hub Enterprise subscription. Please see the overview page for more details.

Required Parameters How to use Description
OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.
ID &id= The ID of an event. Can be included multiple times to pull multiple events.

Optional Parameters How to use Description
Include deleted includeDeletes=true If specified as true, will include deleted events.