GET
/
crm
/
v3
/
objects
/
contacts
/
{contactId}
Retrieve a contact
curl --request GET \
  --url https://api.hubapi.com/crm/v3/objects/contacts/{contactId} \
  --header 'Authorization: Bearer <token>'
{
  "associations": "{\"companies\":{\"results\":[{\"id\":\"29846388244\",\"type\":\"contact_to_company\"},{\"id\":\"29846388244\",\"type\":\"contact_to_company_unlabeled\"}]}}",
  "createdAt": "2023-11-07T05:31:56Z",
  "archived": false,
  "archivedAt": "2023-11-07T05:31:56Z",
  "propertiesWithHistory": "{\"lastname\":[{\"value\":\"Scout\",\"sourceId\":\"userId:2931299\",\"timestamp\":\"2025-02-11T16:28:13.591Z\",\"sourceType\":\"CRM_UI\",\"updatedByUserId\":2931299},{\"value\":\"S.\",\"sourceId\":\"userId:2931299\",\"timestamp\":\"2025-02-11T15:45:00.400Z\",\"sourceType\":\"CRM_UI\",\"updatedByUserId\":2931299}]}",
  "id": "",
  "objectWriteTraceId": "<string>",
  "properties": "{\"email\":\"mark.s@lumon.industries\",\"lastname\":\"S.\",\"firstname\":\"Mark\",\"createdate\":\"2025-02-11T15:45:00.400Z\",\"hs_object_id\":\"98630638716\",\"lastmodifieddate\":\"2025-02-11T15:52:10.273Z\"}",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Supported products
Requires one of the following products or higher.
Marketing HubMarketing HubFree
Sales HubSales HubFree
Service HubService HubFree
Content HubContent HubFree

​
Required Scopes

This API requires one of the following scopes:
  • crm.objects.contacts.read

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
contactId
string
required

The ID of the contact to retrieve.

Query Parameters

​
properties
string[]

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.

​
propertiesWithHistory
string[]

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.

​
associations
string[]

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.

​
archived
boolean
default:false

Whether to return only results that have been archived.

Response

200
application/json

successful operation

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