Sign in

v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
Companies

Scroll over all companies

  The `list all companies` functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply. The Scroll API provides an efficient mechanism for iterating over all companies in a dataset.
  • Each app can only have 1 scroll open at a time. You'll get an error message if you try to have more than one open per app.
  • If the scroll isn't used for 1 minute, it expires and calls with that scroll param will fail
  • If the end of the scroll is reached, "companies" will be empty and the scroll parameter will expire

{% admonition type="info" name="Scroll Parameter" %} You can get the first page of companies by simply sending a GET request to the scroll endpoint. For subsequent requests you will need to use the scroll parameter from the response. {% /admonition %} {% admonition type="danger" name="Scroll network timeouts" %} Since scroll is often used on large datasets network errors such as timeouts can be encountered. When this occurs you will see a HTTP 500 error with the following message: "Request failed due to an internal network error. Please restart the scroll operation." If this happens, you will need to restart your scroll query: It is not possible to continue from a specific point when using scroll. {% /admonition %}

get/companies/scroll

Query parameters

scroll_paramstring

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.

Example:2.14

Response

Successful

type'list'

The type of object - list

total_countinteger nullable

The total number of companies

scroll_paramstring

The scroll parameter to use in the next request to fetch the next page of results.

Example response

{
  "type": "list",
  "data": [
    {
      "type": "company",
      "id": "531ee472cce572a6ec000006",
      "name": "Blue Sun",
      "app_id": "ecahpwf5",
      "plan": {
        "type": "plan",
        "id": "269315",
        "name": "Pro"
      },
      "company_id": "6",
      "remote_created_at": 1663597223,
      "created_at": 1663597223,
      "updated_at": 1663597223,
      "last_request_at": 1663597223,
      "size": 100,
      "website": "https://www.intercom.com",
      "industry": "Software",
      "monthly_spend": 100,
      "session_count": 100,
      "user_count": 100,
      "custom_attributes": {
        "paid_subscriber": true,
        "monthly_spend": 155.5,
        "team_mates": 9
      },
      "tags": {
        "tags": [
          {
            "type": "tag",
            "id": "123456",
            "name": "Test tag"
          }
        ]
      },
      "segments": {
        "segments": [
          {
            "type": "segment",
            "id": "56203d253cba154d39010062",
            "name": "Active",
            "created_at": 1394621988,
            "updated_at": 1394622004,
            "person_type": "contact",
            "count": 3
          }
        ]
      }
    }
  ],
  "pages": {
    "type": "pages",
    "page": 1,
    "next": {
      "per_page": 2,
      "starting_after": "your-cursor-from-response"
    },
    "per_page": 2,
    "total_pages": 13
  },
  "total_count": 100,
  "scroll_param": "25b649f7-4d33-4ef6-88f5-60e5b8244309"
}