Intercom API (unofficial showcase)
GET/companies/{company_id}

Retrieve a company by ID

Retrieves a company by its Intercom-assigned identifier. Use the company_id path parameter to select the company whose details you need.

2 parameters
company_idstringrequired
The Intercom-assigned unique identifier of the company to retrieve.
Intercom-Versionstringoptional
Selects the API version. Defaults to `2.17` when omitted; supported versions include 1.0 through 1.4 and 2.0 through 2.6.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns the company object, including its Intercom ID, name, company ID, plan, website, industry, spend, and timestamps.
typestringoptional
Value is `company`
Allowed:company
idstringoptional
The Intercom defined id representing the company.
namestringoptional
The name of the company.
app_idstringoptional
The Intercom defined code of the workspace the company is associated to.
planobjectoptional
company_idstringoptional
The company id you have defined for the company.
remote_created_atintegeroptional
The time the company was created by you.
created_atintegeroptional
The time the company was added in Intercom.
updated_atintegeroptional
The last time the company was updated.
last_request_atintegeroptional
The time the company last recorded making a request.
sizeintegeroptional
The number of employees in the company.
websitestringoptional
The URL for the company website.
industrystringoptional
The industry that the company operates in.
monthly_spendintegeroptional
How much revenue the company generates for your business.
session_countintegeroptional
How many sessions the company has recorded.
user_countintegeroptional
The number of users in the company.
custom_attributesobjectoptional
The custom attributes you have set on the company.
tagsobjectoptional
The list of tags associated with the company
segmentsobjectoptional
The list of segments associated with the company
notesobjectoptional
The list of notes associated with the company
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the company does not exist.

One documented failure

  • company_not_found

    Company Not Found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized. A 404 is returned when the company_id path parameter does not identify an existing company.