HUhubspot
Basic

Retrieve a list of subscription objects.

Changed on

Retrieve a list of subscription objects, with options to filter by properties, associations, and archived status.

get/crm/objects/2026-03/subscriptions

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/objects/2026-03/subscriptions
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Query parameters

afterstring

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

archivedboolean

Whether to return only results that have been archived.

associationsstring[]

A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored.

limitinteger

The maximum number of results to display per page.

propertiesstring[]

A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored.

propertiesWithHistorystring[]

A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request.

Response

successful operation

Changes

Some revisions have not been checked yet.