Company User/Segment/Tag Count Model

Company User/Segment/Tag Count Object

AttributeTypeDescription
typestringvalue is 'count'
companyobjectContains a field called segment containing segment counts
company.segmentarrayContains a list of segment objects their name and their number of companies tagged
company.tagarrayContains a list of tag objects with their name and their number of companies tagged
company.userarrayContains an array of companies with their name and their number of users
# Company Tag Count\n$ curl 'https://api.intercom.io/counts?type=company&count=tag&per_page=5' \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json'\n\n# Company Segment Count\n$ curl 'https://api.intercom.io/counts?type=company&count=segment' \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json'\n\n# Company User Count\n$ curl 'https://api.intercom.io/counts?type=company&count=user' \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json'
# Company Tag Count\nHTTP/1.1 200 OK\n\n{\n    \"type\": \"count\",\n    \"company\": {\n        \"tag\": [\n            {\n                \"VIP\": 0\n            },\n            {\n                \"UpMarket\": 0\n            },\n            {\n                \"test\": 0\n            },\n            {\n                \"new\": 0\n            },\n            {\n                \"smb\": 0\n            }\n        ]\n    },\n    \"pages\": {\n        \"pages\": {\n            \"type\": \"pages\",\n            \"next\": \"https://api.intercom.io/counts?type=company&count=tag&page=2&per_page=5\",\n            \"page\": 1,\n            \"per_page\": 5,\n            \"total_pages\": 203\n        }\n    }\n}\n\n# Company Segment Count\nHTTP/1.1 200 OK\n{\n    \"type\": \"count\",\n    \"company\": {\n        \"segment\": [\n            {\n                \"Active\": 2\n            },\n            {\n                \"New\": 0\n            },\n            {\n                \"Slipping Away\": 0\n            },\n            {\n                \"id=10\": 10\n            }\n        ]\n    },\n    \"pages\": {}\n}\n\n# Company User Count\nHTTP/1.1 200 OK\n\n{\n  \"type\": \"count\",\n  \"company\": {\n    \"user\": [\n      {\n        \"Independents\": 7,\n        \"remote_company_id\": \"6\"\n      },\n      {\n        \"Alliance\": 1,\n        \"remote_company_id\": \"7\"\n      }\n    ]\n  },\n  \"pages\": {}\n}

The counts for your App can be obtained using GET against the https://api.intercom.io/counts URL with the type and count parameters as follows

CountType ValueCount Value
Company Segment Countcompanysegment
Company Tag Countcompanytag
Company User Countcompanyuser

🚧 Pagination with company counts

Company tag counts are returned via pagination, which means it defaults to 50 results per page unless you specify otherwise. e.g. 'https://api.intercom.io/counts?type=company&count=tag&per_page=10"

To get the next page of results you need to make a GET request with the "next" RUL supplied in the initial response.