Skip to main content
GET
/
companies
/
v2
/
companies
/
{companyId}
/
contacts
Get Contacts at a Company
curl --request GET \
  --url https://api.hubapi.com/companies/v2/companies/{companyId}/contacts
{
  "contacts": [
    {
      "identities": [
        {
          "vid": 23511,
          "identity": [
            {
              "value": "rswanson@parksrec.com",
              "type": "EMAIL",
              "timestamp": 1394223876431
            },
            {
              "value": "1a658c50-fc00-47b5-b920-3079c03b6369",
              "type": "LEAD_GUID",
              "timestamp": 1394223876535
            }
          ],
          "linkedvid": []
        },
        {
          "vid": 23510,
          "identity": [
            {
              "value": "rswan@parksandrec.com",
              "type": "EMAIL",
              "timestamp": 1394222641382
            },
            {
              "value": "d98d7590-ad15-463e-aa9d-f7070199d913",
              "type": "LEAD_GUID",
              "timestamp": 1394222641428
            }
          ],
          "linkedvid": []
        }
      ],
      "properties": [
        {
          "name": "lastname",
          "value": "Swanson",
          "sourceVid": []
        },
        {
          "name": "firstname",
          "value": "Ron",
          "sourceVid": []
        },
        {
          "name": "lastmodifieddate",
          "value": "1403134876842",
          "sourceVid": []
        }
      ],
      "listMembership": [],
      "vid": 23511,
      "portalid": 62515,
      "isContact": true,
      "vids": [],
      "imports": [],
      "publicToken": "AO_T-mO3IQOR49eMkLukTZMtEMbVMbpeRbF6gREcu9lpDKiAGqI36EAIqORKFd2LFN11x-YmQs5DsUGlFH8hsXWR9T0Aj85_Tp0e76Pmzze2P6XmxfrgevzJHWSo4ENDRRObVX1N5wFO",
      "canonicalVid": 23511,
      "mergeAudit": [
        {
          "canonicalVid": 23511,
          "vidToMerge": 23510,
          "timestamp": 1403130666794,
          "userId": 100291,
          "entityId": "",
          "numPropertiesMoved": 39,
          "email": "rswan@parksandrec.com",
          "firstName": "Ron",
          "lastName": "Swanson"
        }
      ],
      "mergedVids": [
        23511,
        23510
      ]
    }
  ],
  "vidOffset": 23511,
  "hasMore": false
}

​
Required Scopes

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

Query Parameters

​
offset
string

This is used to get the next page of results. Each request will return an offset in the response, and you'd use that offset in the URL of your next request to get the next page of results.

​
count
string

Specifies the number of companies to be returned.

​
since
string

Only return companies modified or created after timestamp x. x must be a UNIX formatted timestamp in milliseconds.

Response

200 - application/json

Successful response - Returns a list of all companies sorted by the date the companies were most recently modified or created

The response is of type object.