> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
---
id: f5512ae6-e3e8-4389-888b-30c5e4f19f80
---
# Get filters for a subscription
> Retrieve the filters associated with a specific webhook subscription in the HubSpot account. This endpoint is useful for obtaining detailed information about the filters applied to a given subscription, identified by its subscription ID.
export const SupportedProducts = ({marketing, sales, service, cms, data, commerce, crm, marketingLevel, salesLevel, serviceLevel, cmsLevel, dataLevel, commerceLevel, crmLevel}) => {
const translations = {
description: "Requires one of the following products or higher.",
productNames: {
marketing: "Marketing Hub",
sales: "Sales Hub",
service: "Service Hub",
cms: "Content Hub",
data: "Data Hub",
commerce: "Revenue Hub",
crm: "Smart CRM"
},
tiers: {
free: "Free",
starter: "Starter",
professional: "Professional",
enterprise: "Enterprise"
}
};
const translateTier = tier => {
if (!tier) return '';
const lowerTier = tier.toLowerCase();
return translations.tiers[lowerTier] || tier;
};
const products = [{
name: marketing ? translations.productNames.marketing : '',
level: translateTier(marketingLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/MarketingHub.svg",
alt: "Marketing Hub"
}, {
name: sales ? translations.productNames.sales : '',
level: translateTier(salesLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SalesHub.svg",
alt: "Sales Hub"
}, {
name: service ? translations.productNames.service : '',
level: translateTier(serviceLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ServiceHub.svg",
alt: "Service Hub"
}, {
name: cms ? translations.productNames.cms : '',
level: translateTier(cmsLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ContentHub.svg",
alt: "Content Hub"
}, {
name: data ? translations.productNames.data : '',
level: translateTier(dataLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/DataHub.svg",
alt: "Data Hub"
}, {
name: commerce ? translations.productNames.commerce : '',
level: translateTier(commerceLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base/subscription_key_icons/commerce_icon.svg",
alt: "Revenue Hub"
}, {
name: crm ? translations.productNames.crm : '',
level: translateTier(crmLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SmartCRM.svg",
alt: "Smart CRM"
}].filter(product => product.name && product.level);
if (products.length === 0) return null;
return
{translations.description}
{products.map((product, index) =>
{product.name} -{product.level}
)}
;
};
## OpenAPI
````yaml specs/2026-03/webhooks-webhooks-v2026-03.json GET /webhooks-journal/subscriptions/2026-03/filters/subscription/{subscriptionId}
openapi: 3.0.1
info:
title: Webhooks Webhooks
description: Basepom for all HubSpot Projects
version: 2026-03
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
- name: Batch
paths:
/webhooks-journal/subscriptions/2026-03/filters/subscription/{subscriptionId}:
get:
tags:
- Basic
summary: Retrieve Filters
description: >-
Retrieve the filters associated with a specific webhook subscription in
the HubSpot account. This endpoint is useful for obtaining detailed
information about the filters applied to a given subscription,
identified by its subscription ID.
operationId: >-
get-/webhooks-journal/subscriptions/2026-03/filters/subscription/{subscriptionId}_/webhooks-journal/subscriptions/2026-03/filters/subscription/{subscriptionId}
parameters:
- name: subscriptionId
in: path
required: true
style: simple
explode: false
schema:
type: integer
format: int64
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FilterResponse'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- webhooks-journal-subscription-read
components:
schemas:
FilterResponse:
required:
- createdAt
- filter
- id
type: object
properties:
createdAt:
type: integer
description: >-
A Unix timestamp in milliseconds indicating when the filter was
created.
format: int64
filter:
$ref: '#/components/schemas/Filter'
id:
type: integer
description: >-
The unique identifier for the filter. It is an integer in int64
format.
format: int64
Filter:
required:
- conditions
type: object
properties:
conditions:
type: array
description: >-
An array of conditions that define the criteria for the filter. Each
condition specifies a property, an operator, and optionally a value
or values.
items:
$ref: '#/components/schemas/Condition'
description: >-
Defines a single condition for searching CRM objects, specifying the
property to filter on, the operator to use (such as equals, greater
than, or contains), and the value(s) to compare against.
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: The error category
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Context about the error condition
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
A unique identifier for the request. Include this value with any
error reports or support tickets
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: further information about the error
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
A map of link names to associated URIs containing documentation
about the error or recommended remediation steps
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate
example: An error occurred
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error
description: >-
Represents an error response returned by the API when an operation
fails. This component is used in various endpoints to provide detailed
information about the error encountered.
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
Condition:
required:
- filterType
- operator
- property
type: object
properties:
filterType:
type: string
description: >-
A string indicating the type of filter being applied. Valid value is
'CRM_OBJECT_PROPERTY'.
enum:
- CRM_OBJECT_PROPERTY
operator:
type: string
description: >-
A string specifying the operation to be performed in the condition.
Valid values include 'EQ', 'N_EQ', 'LT', 'GT', 'LTE', 'GTE',
'CONTAINS', 'STARTS_WITH', 'ENDS_WITH', 'IN', 'NOT_IN', 'IS_EMPTY',
and 'IS_NOT_EMPTY'.
enum:
- CONTAINS
- ENDS_WITH
- EQ
- GT
- GTE
- IN
- IS_EMPTY
- IS_NOT_EMPTY
- LT
- LTE
- N_EQ
- NOT_IN
- STARTS_WITH
property:
type: string
description: >-
A string representing the specific property of the CRM object that
the condition applies to.
value:
type: string
description: >-
A string representing the value to be compared against the specified
property when using single-value operators.
values:
type: array
description: >-
An array of strings used to specify multiple values for comparison
when using operators that support multiple values, such as 'IN' or
'NOT_IN'.
items:
type: string
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: The status code associated with the error detail
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Context about the error condition
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: The name of the field or parameter in which the error was found.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error
description: >-
Represents detailed information about an error that occurred in the API.
This component is used to provide additional context and specifics about
errors, typically as part of an error response.
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
developers-read: ''
developers-write: ''
private-apps-read: ''
private-apps-write: ''
webhooks-journal-data-access: ''
webhooks-journal-snapshot-management: ''
webhooks-journal-subscription-management: ''
webhooks-journal-subscription-read: ''
````
{product.name} -
{product.level}
)}