---
title: "Changes to Retrieve event definitions"
method: GET
path: "/events/v3/event-definitions"
---

# Changes to Retrieve event definitions

`GET /events/v3/event-definitions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 43 of 141 revisions.

- **2026-10-16** (v3) `ed9a1391fdff`: 25 info
- **2026-08-14** (v3) `b12482347df4`: 1 info
- **2026-07-13** (v3) `8d341c0a911c`: 1 breaking
- **2026-07-13** (v3) `7afd5ac6fbf1`: 1 info
- **2026-07-13** (v3) `ae745d244e14`: 1 breaking
- **2026-06-16** (v3) `9842d96d5c67`: 2 breaking
- **2026-06-16** (v3) `3101530c65bf`: 2 info
- **2026-06-15** (v3) `9842d96d5c67`: 7 breaking, 41 warning, 1 info
- **2026-06-15** (v3) `ccd8162a29fa`: 4 breaking, 45 info
- **2026-06-09** (v3) `9842d96d5c67`: 2 breaking
- **2026-06-09** (v3) `3101530c65bf`: 2 info
- **2026-06-05** (v3) `9842d96d5c67`: 2 breaking
- **2026-06-05** (v3) `3101530c65bf`: 2 info
- **2026-06-03** (v3) `50e3766125f5`: 2 breaking
- **2026-06-03** (v3) `3d7b8deb2f28`: 2 info
- **2026-06-02** (v3) `50e3766125f5`: 2 breaking
- **2026-06-02** (v3) `3d7b8deb2f28`: 2 info
- **2026-06-01** (v3) `50e3766125f5`: 2 breaking
- **2026-06-01** (v3) `3d7b8deb2f28`: 2 info
- **2026-05-27** (v3) `50e3766125f5`: 2 breaking
- **2026-05-27** (v3) `3d7b8deb2f28`: 2 info
- **2026-05-26** (v3) `50e3766125f5`: 1 info
- **2026-05-26** (v3) `9028f1ff9bf9`: 2 breaking
- **2026-05-26** (v3) `2d9ebdddd778`: 2 info
- **2026-05-25** (v3) `9028f1ff9bf9`: 2 breaking
- **2026-05-25** (v3) `2d9ebdddd778`: 2 info
- **2026-05-22** (v3) `9028f1ff9bf9`: 2 info
- **2026-05-20** (v3) `4fe0932c7e21`: 2 breaking
- **2026-05-20** (v3) `cea1c2aa4d10`: 2 info
- **2026-05-19** (v3) `4fe0932c7e21`: 2 breaking
- **2026-05-19** (v3) `cea1c2aa4d10`: 2 info
- **2026-05-15** (v3) `4fe0932c7e21`: 2 breaking
- **2026-05-15** (v3) `cea1c2aa4d10`: 2 info
- **2026-05-06** (v3) `0dff78d491a8`: 15 breaking
- **2026-04-20** (v3) `08613de113bd`: 6 info
- **2026-04-09** (v3) `c33aebb4b2f8`: 9 info
- **2026-04-01** (v3) `92a55bb7168e`: 1 warning, 3 info
- **2026-03-24** (v3) `10832d441706`: 1 breaking
- **2026-01-12** (v3) `bf466fa030ec`: 3 breaking, 7 warning, 39 info
- **2025-11-05** (v3) `57d7d02df1d0`: 2 info
- **2025-10-26** (v3) `22a2454ecf46`: 4 info
- **2024-06-21** (v3) `a7185ee004f2`: 19 warning, 3 info
- **2024-03-29** (v3) `65a4c322e991`: 2 info

## Changes

- **2026-10-16** (v3) `ed9a1391fdff`: 25 info
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #10: property-updated-comparative]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #11: datetime-rolling]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #12: rolling-property-updated]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: enumeration]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #6: timepoint]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #7: rangedtime]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #15: number-ranged]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/pruningRefineBy/oneOf[subschema #6: timepoint]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/pruningRefineBy/oneOf[subschema #7: rangedtime]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #17: date]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #18: calendar-date]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #19: timepoint]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #1: bool]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #20: rangedtime]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #21: regex]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #2: number]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #3: string]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #4: datetime]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #5: datetime-ranged]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #6: datetime-comparative]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #7: bool-comparative]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #8: number-comparative]/propertyAspect` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #9: string-comparative]/propertyAspect` to the response with the `200` status
- **2026-08-14** (v3) `b12482347df4`: 1 info
  - endpoint added
- **2026-07-13** (v3) `8d341c0a911c`: 1 breaking
  - api path removed without deprecation
- **2026-07-13** (v3) `7afd5ac6fbf1`: 1 info
  - endpoint added
- **2026-07-13** (v3) `ae745d244e14`: 1 breaking
  - api path removed without deprecation
- **2026-06-16** (v3) `9842d96d5c67`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-06-16** (v3) `3101530c65bf`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-06-15** (v3) `9842d96d5c67`: 7 breaking, 41 warning, 1 info
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
  - added `#/components/schemas/BoolPropertyOperation, #/components/schemas/NumberPropertyOperation, #/components/schemas/StringPropertyOperation, #/components/schemas/DateTimePropertyOperation, #/components/schemas/RangedDatePropertyOperation, #/components/schemas/ComparativeDatePropertyOperation, #/components/schemas/ComparativeBoolPropertyOperation, #/components/schemas/ComparativeNumberPropertyOperation, #/components/schemas/ComparativeStringPropertyOperation, #/components/schemas/ComparativePropertyUpdatedOperation, #/components/schemas/RollingDateRangePropertyOperation, #/components/schemas/RollingPropertyUpdatedOperation, #/components/schemas/EnumerationPropertyOperation, #/components/schemas/AllPropertyTypesOperation, #/components/schemas/RangedNumberPropertyOperation, #/components/schemas/MultiStringPropertyOperation, #/components/schemas/DatePropertyOperation, #/components/schemas/CalendarDatePropertyOperation, #/components/schemas/TimePointOperation, #/components/schemas/RangedTimeOperation, #/components/schemas/RegexPropertyOperation` to the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation` response property `oneOf` list for the response status `200`
  - the `results/items/comboEventRules/composingRules/items/eventTypeId` response's property type changed from `object` to `string` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation` response's property type changed from `object` to no type for status `200`
  - the `results/items/objectTypeId` response's property type changed from `object` to `string` for status `200`
  - the `results/items/primaryObjectId` response's property type changed from `object` to `string` for status `200`
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/hubSpotDefinedEventType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/hubSpotDefinedObjectType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/innerId` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/integrationDefinedEventType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/integrationDefinedObjectType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/keyString` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/legacyObjectType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/metaType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/metaTypeId` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/portalSpecific` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/portalSpecificEventType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/portalSpecificObjectType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/defaultValue` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/includeObjectsWithNoValueSet` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/operationType` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/operatorName` from the response with the `200` status
  - removed the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/renderSpec` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/hubSpotDefinedEventType` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/hubSpotDefinedObjectType` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/innerId` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/integrationDefinedEventType` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/integrationDefinedObjectType` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/keyString` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/legacyObjectType` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/metaType` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/metaTypeId` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/portalSpecific` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/portalSpecificEventType` from the response with the `200` status
  - removed the optional property `results/items/objectTypeId/portalSpecificObjectType` from the response with the `200` status
  - removed the optional property `results/items/primaryObjectId/hubSpotDefinedEventType` from the response with the `200` status
  - removed the optional property `results/items/primaryObjectId/hubSpotDefinedObjectType` from the response with the `200` status
  - removed the optional property `results/items/primaryObjectId/innerId` from the response with the `200` status
  - removed the optional property `results/items/primaryObjectId/integrationDefinedEventType` from the response with the `200` status
  - …9 more
- **2026-06-15** (v3) `ccd8162a29fa`: 4 breaking, 45 info
  - the `results/items/comboEventRules/composingRules/items/eventTypeId` response's property type changed from `string` to `object` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation` response's property type changed from no type to `object` for status `200`
  - the `results/items/objectTypeId` response's property type changed from `string` to `object` for status `200`
  - the `results/items/primaryObjectId` response's property type changed from `string` to `object` for status `200`
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/hubSpotDefinedEventType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/hubSpotDefinedObjectType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/innerId` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/integrationDefinedEventType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/integrationDefinedObjectType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/keyString` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/legacyObjectType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/metaType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/metaTypeId` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/portalSpecific` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/portalSpecificEventType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/eventTypeId/portalSpecificObjectType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/defaultValue` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/includeObjectsWithNoValueSet` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/operationType` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/operatorName` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/renderSpec` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/hubSpotDefinedEventType` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/hubSpotDefinedObjectType` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/innerId` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/integrationDefinedEventType` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/integrationDefinedObjectType` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/keyString` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/legacyObjectType` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/metaType` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/metaTypeId` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/portalSpecific` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/portalSpecificEventType` to the response with the `200` status
  - added the optional property `results/items/objectTypeId/portalSpecificObjectType` to the response with the `200` status
  - added the optional property `results/items/primaryObjectId/hubSpotDefinedEventType` to the response with the `200` status
  - added the optional property `results/items/primaryObjectId/hubSpotDefinedObjectType` to the response with the `200` status
  - added the optional property `results/items/primaryObjectId/innerId` to the response with the `200` status
  - added the optional property `results/items/primaryObjectId/integrationDefinedEventType` to the response with the `200` status
  - added the optional property `results/items/primaryObjectId/integrationDefinedObjectType` to the response with the `200` status
  - added the optional property `results/items/primaryObjectId/keyString` to the response with the `200` status
  - added the optional property `results/items/primaryObjectId/legacyObjectType` to the response with the `200` status
  - …9 more
- **2026-06-09** (v3) `9842d96d5c67`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-06-09** (v3) `3101530c65bf`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-06-05** (v3) `9842d96d5c67`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-06-05** (v3) `3101530c65bf`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-06-03** (v3) `50e3766125f5`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-06-03** (v3) `3d7b8deb2f28`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-06-02** (v3) `50e3766125f5`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-06-02** (v3) `3d7b8deb2f28`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-06-01** (v3) `50e3766125f5`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-06-01** (v3) `3d7b8deb2f28`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-05-27** (v3) `50e3766125f5`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-05-27** (v3) `3d7b8deb2f28`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-05-26** (v3) `50e3766125f5`: 1 info
  - added the optional property `results/items/properties/items/textDisplayHint` to the response with the `200` status
- **2026-05-26** (v3) `9028f1ff9bf9`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-05-26** (v3) `2d9ebdddd778`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-05-25** (v3) `9028f1ff9bf9`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-05-25** (v3) `2d9ebdddd778`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-05-22** (v3) `9028f1ff9bf9`: 2 info
  - the security scope `behavioral_events.event_definitions.read_write` was added to the endpoint's security scheme `oauth2`
  - the security scope `behavioral-events-external-api` was removed from the endpoint's security scheme `oauth2`
- **2026-05-20** (v3) `4fe0932c7e21`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-05-20** (v3) `cea1c2aa4d10`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-05-19** (v3) `4fe0932c7e21`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-05-19** (v3) `cea1c2aa4d10`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-05-15** (v3) `4fe0932c7e21`: 2 breaking
  - the response property `results/items/properties/items/options/items/description` became optional for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became optional for the status `200`
- **2026-05-15** (v3) `cea1c2aa4d10`: 2 info
  - the response property `results/items/properties/items/options/items/description` became required for the status `200`
  - the response property `results/items/properties/items/options/items/displayOrder` became required for the status `200`
- **2026-05-06** (v3) `0dff78d491a8`: 15 breaking
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #1: RelativeComparativeTimestampRefineBy]/timeOffset/amount` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #2: RelativeRangedTimestampRefineBy]/lowerBoundOffset/amount` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #2: RelativeRangedTimestampRefineBy]/upperBoundOffset/amount` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #3: AbsoluteComparativeTimestampRefineBy]/timestamp` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #4: AbsoluteRangedTimestampRefineBy]/lowerTimestamp` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #4: AbsoluteRangedTimestampRefineBy]/upperTimestamp` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/pruningRefineBy/oneOf[subschema #1: RelativeComparativeTimestampRefineBy]/timeOffset/amount` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/pruningRefineBy/oneOf[subschema #2: RelativeRangedTimestampRefineBy]/lowerBoundOffset/amount` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/pruningRefineBy/oneOf[subschema #2: RelativeRangedTimestampRefineBy]/upperBoundOffset/amount` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/pruningRefineBy/oneOf[subschema #3: AbsoluteComparativeTimestampRefineBy]/timestamp` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/pruningRefineBy/oneOf[subschema #4: AbsoluteRangedTimestampRefineBy]/lowerTimestamp` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: multistring]/pruningRefineBy/oneOf[subschema #4: AbsoluteRangedTimestampRefineBy]/upperTimestamp` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #4: datetime]/timestamp` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #5: datetime-ranged]/lowerBoundTimestamp` response's property format changed from `int32` to `int64` for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #5: datetime-ranged]/upperBoundTimestamp` response's property format changed from `int32` to `int64` for status `200`
- **2026-04-20** (v3) `08613de113bd`: 6 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
  - added the optional property `results/items/detailTemplate` to the response with the `200` status
  - added the optional property `results/items/headerTemplate` to the response with the `200` status
- **2026-04-09** (v3) `c33aebb4b2f8`: 9 info
  - the endpoint scheme security `app_cookie` was added to the API
  - the endpoint scheme security `hapikey` was added to the API
  - the endpoint scheme security `internal_cookie` was added to the API
  - the endpoint scheme security `shhkey` was added to the API
  - the endpoint scheme security `private_apps` was removed from the API
  - the security scope `behavioral-events-external-api` was added to the endpoint's security scheme `oauth2`
  - the security scope `behavioral_events.event_definitions.read_write` was removed from the endpoint's security scheme `oauth2`
  - added the optional property `results/items/properties/items/currencyPropertyName` to the response with the `200` status
  - added the optional property `results/items/properties/items/numberDisplayHint` to the response with the `200` status
- **2026-04-01** (v3) `92a55bb7168e`: 1 warning, 3 info
  - added the new `CUSTOM_SIGNAL` enum value to the `results/items/trackingType` response property for the response status `200`
  - api tag `Basic` added
  - api tag `External_Events_Definition` removed
  - added the optional property `paging/prev` to the response with the `200` status
- **2026-03-24** (v3) `10832d441706`: 1 breaking
  - added `#/components/schemas/RegexPropertyOperation` to the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation` response property `oneOf` list for the response status `200`
- **2026-01-12** (v3) `bf466fa030ec`: 3 breaking, 7 warning, 39 info
  - added `#/components/schemas/ComparativeBoolPropertyOperation, #/components/schemas/ComparativeNumberPropertyOperation, #/components/schemas/ComparativeStringPropertyOperation` to the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation` response property `oneOf` list for the response status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #12: number-ranged -> subschema #15: number-ranged]/lowerBound` response's property type changed from `integer` to `number`, and format from `int32` to no format for status `200`
  - the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #12: number-ranged -> subschema #15: number-ranged]/upperBound` response's property type changed from `integer` to `number`, and format from `int32` to no format for status `200`
  - added the new `APP_EVENT` enum value to the `results/items/trackingType` response property for the response status `200`
  - added the new `AUTOCAPTURE_EVENT` enum value to the `results/items/trackingType` response property for the response status `200`
  - added the new `CONTAINS_EXACTLY` enum value to the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: multistring -> subschema #16: multistring]/operator` response property for the response status `200`
  - added the new `DOES_NOT_CONTAIN_EXACTLY` enum value to the `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: multistring -> subschema #16: multistring]/operator` response property for the response status `200`
  - added the new `PROSPECTING_AGENT_CONTACT_ASSIGNMENT` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `PROSPECTING_AGENT_CONTACT_ASSIGNMENT` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `WORK` enum value to the `results/items/associations/items/category` response property for the response status `200`
  - added the optional property `results/items/associations/items/hiddenReason` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/context` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/filterInsightsId` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #10: enumeration -> subschema #13: enumeration]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #11: alltypes -> subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #6: timepoint]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #11: alltypes -> subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #6: timepoint]/timePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #11: alltypes -> subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #7: rangedtime]/lowerBoundTimePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #11: alltypes -> subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #7: rangedtime]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #11: alltypes -> subschema #14: alltypes]/pruningRefineBy/oneOf[subschema #7: rangedtime]/upperBoundTimePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #11: alltypes -> subschema #14: alltypes]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #12: number-ranged -> subschema #15: number-ranged]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: multistring -> subschema #16: multistring]/pruningRefineBy/oneOf[subschema #6: timepoint]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: multistring -> subschema #16: multistring]/pruningRefineBy/oneOf[subschema #6: timepoint]/timePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: multistring -> subschema #16: multistring]/pruningRefineBy/oneOf[subschema #7: rangedtime]/lowerBoundTimePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: multistring -> subschema #16: multistring]/pruningRefineBy/oneOf[subschema #7: rangedtime]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: multistring -> subschema #16: multistring]/pruningRefineBy/oneOf[subschema #7: rangedtime]/upperBoundTimePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #13: multistring -> subschema #16: multistring]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #14: date -> subschema #17: date]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #15: calendar-date -> subschema #18: calendar-date]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: timepoint -> subschema #19: timepoint]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #16: timepoint -> subschema #19: timepoint]/timePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #17: rangedtime -> subschema #20: rangedtime]/lowerBoundTimePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #17: rangedtime -> subschema #20: rangedtime]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #17: rangedtime -> subschema #20: rangedtime]/upperBoundTimePoint/oneOf[subschema #2: INDEXED]/shouldGenerateRefreshTime` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #1: bool]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #2: number]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #3: string]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #4: datetime]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #5: datetime-ranged]/renderSpec` to the response with the `200` status
  - added the optional property `results/items/comboEventRules/composingRules/items/propertyFilters/items/operation/oneOf[subschema #6: datetime-comparative]/renderSpec` to the response with the `200` status
  - …9 more
- **2025-11-05** (v3) `57d7d02df1d0`: 2 info
  - api tag `External_Events_Definition` added
  - api tag `Event definition` removed
- **2025-10-26** (v3) `22a2454ecf46`: 4 info
  - the endpoint scheme security `oauth2` was added to the API
  - the endpoint scheme security `private_apps` was added to the API
  - the endpoint scheme security `oauth2_legacy` was removed from the API
  - the endpoint scheme security `private_apps_legacy` was removed from the API
- **2024-06-21** (v3) `a7185ee004f2`: 19 warning, 3 info
  - added the new `AUTOMATION_JOURNEY` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `AUTOMATION_JOURNEY` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `CASE_STUDY` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `CASE_STUDY` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `COMBO_EVENT` enum value to the `results/items/trackingType` response property for the response status `200`
  - added the new `COMBO_EVENT_CONFIGURATION` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `COMBO_EVENT_CONFIGURATION` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `CRM_OBJECTS_DUMMY_TYPE` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `CRM_OBJECTS_DUMMY_TYPE` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `PARTNER_CLIENT_REVENUE` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `PARTNER_CLIENT_REVENUE` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `PARTNER_SERVICE` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `PARTNER_SERVICE` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `PODCAST_EPISODE` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `PODCAST_EPISODE` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `PROPERTY_CHANGE` enum value to the `results/items/trackingType` response property for the response status `200`
  - added the new `SERVICE` enum value to the `results/items/associations/items/fromObjectType` response property for the response status `200`
  - added the new `SERVICE` enum value to the `results/items/associations/items/toObjectType` response property for the response status `200`
  - added the new `WEBHOOK` enum value to the `results/items/trackingType` response property for the response status `200`
  - added the optional property `results/items/comboEventRules` to the response with the `200` status
  - added the optional property `results/items/properties/items/dataSensitivity` to the response with the `200` status
  - added the optional property `results/items/properties/items/sensitiveDataCategories` to the response with the `200` status
- **2024-03-29** (v3) `65a4c322e991`: 2 info
  - api tag `Event definition` added
  - api tag `External_Events_Definition` removed

---

[Operation](https://skmtc.dev/hubspot/apis/events-manage-event-definitions/docs/events/v3/event-definitions/get.md) - [API](https://skmtc.dev/hubspot/apis/events-manage-event-definitions.md) - [Page](https://skmtc.dev/hubspot/apis/events-manage-event-definitions/changes/events/v3/event-definitions/get)
