Method Details
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing & CRM
Required Scope:
For a given account, return information about a group of contacts by their user tokens. A visitor's user token is stored in the hubspotutk cookie. This cookie is created automatically by the HubSpot tracking code.
The endpoint accepts many query parameters that allow for customization based on a variety of integration use cases. By default, this endpoint will not return the history for properties, only the current value of any populated properties, but you can include the history using the parameters listed below.
Requests should be limited to 100 records in a single request.
Note: This endpoint is has been replaced by a new version that returns contacts with the user token as the key value, making it easier to associate utks with contacts. This new endpoint should be prefered over the endpoint described on this page.