Skip to main content
GET
/
crm
/
v3
/
objects
/
subscriptions
/
{subscriptionId}
Retrieve a subscription.
curl --request GET \
  --url https://api.hubapi.com/crm/v3/objects/subscriptions/{subscriptionId} \
  --header 'Authorization: Bearer <token>'
{
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "properties": {},
  "updatedAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "associations": {},
  "objectWriteTraceId": "<string>",
  "propertiesWithHistory": {}
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
subscriptionId
string
required

Query Parameters

​
archived
boolean
default:false

Whether to return only archived results.

​
associations
string[]

A list of associated object types to include in the response.

​
idProperty
string

The name of a unique identifier property, which can be used for identifying objects instead of the object ID.

​
properties
string[]

A list of property names to include in the response.

​
propertiesWithHistory
string[]

A list of property names to include in the response, along with their history.

Response

successful operation

Represents a CRM object along with its properties, timestamps, and a set of associated object IDs grouped by association type.

​
archived
boolean
required

Whether the object is archived.

​
createdAt
string<date-time>
required

The timestamp when the object was created, in ISO 8601 format.

​
id
string
required

The unique ID of the object.

​
properties
object
required

Key value pairs representing the properties of the object.

​
updatedAt
string<date-time>
required

The timestamp when the object was last updated, in ISO 8601 format.

​
archivedAt
string<date-time>

The timestamp when the object was archived, in ISO 8601 format.

​
associations
object

A list defining relationships with other objects.

​
objectWriteTraceId
string
​
propertiesWithHistory
object

Key-value pairs representing the properties of the object along with their history.

Last modified on December 18, 2025