GET
/
companies
/
v2
/
companies
/
{companyId}
Get a company by ID
curl --request GET \
  --url https://api.hubapi.com/companies/v2/companies/{companyId}
"\nExample GET URL:\nhttps://api.hubapi.com/companies/v2/companies/10444744\n\nExample response:\n{\n  \"portalId\": 62515,\n  \"companyId\": 10444744,\n  \"isDeleted\": false,\n  \"properties\": {\n    \"description\": {\n      \"value\": \"A far better description than before\",\n      \"timestamp\": 1403218621658,\n      \"source\": \"API\",\n      \"sourceId\": null,\n      \"versions\": [\n        {\n          \"name\": \"description\",\n          \"value\": \"A far better description than before\",\n          \"timestamp\": 1403218621658,\n          \"source\": \"API\",\n          \"sourceVid\": [\n            \n          ]\n        }\n      ]\n    },\n    \"name\": {\n      \"value\": \"A company name\",\n      \"timestamp\": 1403217668394,\n      \"source\": \"API\",\n      \"sourceId\": null,\n      \"versions\": [\n        {\n          \"name\": \"name\",\n          \"value\": \"A company name\",\n          \"timestamp\": 1403217668394,\n          \"source\": \"API\",\n          \"sourceVid\": [\n            \n          ]\n        }\n      ]\n    },\n    \"createdate\": {\n      \"value\": \"1403217668394\",\n      \"timestamp\": 1403217668394,\n      \"source\": \"API\",\n      \"sourceId\": null,\n      \"versions\": [\n        {\n          \"name\": \"createdate\",\n          \"value\": \"1403217668394\",\n          \"timestamp\": 1403217668394,\n          \"source\": \"API\",\n          \"sourceVid\": [\n            \n          ]\n        }\n      ]\n    }\n  }\n}"

Path Parameters

​
companyId
string
required

Unique identifier for a particular company.

Query Parameters

​
includeMergeAudits
string

Returns any merge history if the company has been previously merged with another company record. Defaults to false.

​
includePropertyVersions
string

Returns the previous versions for all properties of the requested company. Defaults to false.

Response

200 - application/json

Successful response - This endpoint is used to get data about a company in HubSpot, specified by its companyId

The response is of type object.