---
title: "List attached companies for contact"
method: GET
path: "/contacts/{contact_id}/companies"
tags: ["Contacts", "Companies"]
---

# List attached companies for contact

`GET /contacts/{contact_id}/companies`

You can fetch a list of companies that are associated to a contact.

## Path parameters

- `contact_id` string, required

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

successful

- ContactAttachedCompanies — A list of Company Objects
  - `type` 'list' — The type of object
  - `companies` Company[] — An array containing Company Objects
    - `type` 'company' — Value is `company`
    - `id` string — The Intercom defined id representing the company.
    - `name` string — The name of the company.
    - `app_id` string — The Intercom defined code of the workspace the company is associated to.
    - `plan` object
      - `type` string — Value is always "plan"
      - `id` string — The id of the plan
      - `name` string — The name of the plan
    - `company_id` string — The company id you have defined for the company.
    - `remote_created_at` integer — The time the company was created by you.
    - `created_at` integer — The time the company was added in Intercom.
    - `updated_at` integer — The last time the company was updated.
    - `last_request_at` integer — The time the company last recorded making a request.
    - `size` integer — The number of employees in the company.
    - `website` string — The URL for the company website.
    - `industry` string — The industry that the company operates in.
    - `monthly_spend` integer — How much revenue the company generates for your business.
    - `session_count` integer — How many sessions the company has recorded.
    - `user_count` integer — The number of users in the company.
    - `custom_attributes` object — The custom attributes you have set on the company.
    - `tags` object — The list of tags associated with the company
      - `type` 'tag.list' — The type of the object
      - `tags` TagBasic[]
        - `type` string — value is "tag"
        - `id` string — The id of the tag
        - `name` string — The name of the tag
    - `segments` object — The list of segments associated with the company
      - `type` 'segment.list' — The type of the object
      - `segments` Segment[]
        - `type` 'segment' — The type of object.
        - `id` string — The unique identifier representing the segment.
        - `name` string — The name of the segment.
        - `created_at` integer — The time the segment was created.
        - `updated_at` integer — The time the segment was updated.
        - `person_type` 'contact' | 'user' — Type of the contact: contact (lead) or user.
        - `count` integer, nullable — The number of items in the user segment. It's returned when `include_count=true` is included in the request.
  - `total_count` integer — The total number of companies associated to this contact
  - `pages` PagesLink — The majority of list resources in the API are paginated to allow clients to traverse data over multiple requests. Their responses are likely to contain a pages object that hosts pagination links which a client can use to paginate through the data without having to construct a query. The link relations for the pages field are as follows.
    - `type` 'pages'
    - `page` integer
    - `next` string, uri, nullable — A link to the next page of results. A response that does not contain a next link does not have further data to fetch.
    - `per_page` integer
    - `total_pages` integer

## Other responses

- `401` — Unauthorized
- `404` — Contact not found

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)