There's a new version of the HubSpot API

Check out the new API
View Beta Docs

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Get a Group of Events by ID

Last updated January 7, 2025

GET /reports/v2/events/batch

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Required Scope:

business-intelligence

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.

Example URL: https://api.hubapi.com/reports/v2/events/:id

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example request URL: https://api.hubapi.com/reports/v2/events/batch?id=000000142311&id=000000142312 Example response: [ { "id": "000000142311", "name": "Neilsdja", "label": null, "status":"ACTIVE" }, { id:"000000142312", name:"dsasd", label:null, "status":"ACTIVE" } ]