Get a company by ID

Last updated January 28, 2021

GET /companies/v2/companies/:companyId

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:

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

Use cases for this endpoint: You can also use this API for syncing any changes made to a particular company in HubSpot to the corresponding record in an Account-Based Marketing (ABM) system. It can also be used to look up specific attributes of a company.

Response details

  • If the request is successful, returns a 200 response with an object representing the specified company.
  • Returns a 404 error if there is no company record for the specified ID.
Required parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
Company Id Used in the request URL (see above) Unique identifier for a particular company.

Optional parameters How to use Description
Include Merge Audits &includeMergeAudits=true
Used in the request URL
Returns any merge history if the company has been previously merged with another company record. Defaults to false.
Include Property Versions &includePropertyVersions=true
Used in the request URL
Returns the previous versions for all properties of the requested company. Defaults to false.