Get a Company

Last updated April 18, 2019

GET /companies/v2/companies/:companyId

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


Returns an object representing the company with the id :companyId associated with the specified account. Particularly useful if you're performing lookups on specific attributes of a company.

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.

Returns a 200 if request is successful with an object representing the specified company.

Returns a 404 error if there is no company with the specified ID.