View a Company
Example View Request and Response
$ curl \\\n-s https://api.intercom.io/companies?company_id=141 \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H \"Accept:application/json\" \\HTTP/1.1 200 OK\n\n{\n \"type\": \"company\",\n \"id\": \"531ee472cce572a6ec000006\",\n \"name\": \"Example Company Inc.\",\n \"plan\": {\n \"type\":\"plan\",\n \"id\":\"1\",\n \"name\":\"Paid\"\n },\n \"company_id\": \"141\",\n \"remote_created_at\": 1394531169,\n \"created_at\": 1394533506,\n \"updated_at\": 1396874658,\n \"last_request_at\": 1396874658,\n \"monthly_spend\": 49,\n \"session_count\": 26,\n \"user_count\": 10,\n \"custom_attributes\": {\n \"paid_subscriber\" : true,\n \"team_mates\": 0\n }\n}Each company has its own URL -
https://api.intercom.io/companies/{id}
Where {id} is the value of the company's id field. This URL is the company's canonical address in the API.
Request Parameters
| Parameter | Required | Description |
|---|---|---|
| name | no | The name of the company |
| company_id | no | The company_id you have given to the company |
A company can also be fetched by its name using a name or company_id parameter in the url, whose values are the ones you have defined for that company -
https://api.intercom.io/companies?name={name}https://api.intercom.io/companies?company_id={company_id}
The name parameter value should be url encoded when sending, as company names are allowed to have values that either need to be encoded as character data (e.g., whitespace) or are reserved characters (e.g., ':').