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

​
Required Scopes

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

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

The response is of type object.