{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can fetch a single company by passing in `company_id` or `name`.\n\n  `https://api.intercom.io/companies?name={name}`\n\n  `https://api.intercom.io/companies?company_id={company_id}`\n\nYou can fetch all companies and filter by `segment_id` or `tag_id` as a query parameter.\n\n  `https://api.intercom.io/companies?tag_id={tag_id}`\n\n  `https://api.intercom.io/companies?segment_id={segment_id}`\n\nThe list is paged by page number. There is a limit of 10,000 companies; beyond that the request returns a `400` error and you should use the scroll endpoint instead.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"query":{"type":"object","properties":{"name":{"type":"string","examples":["my company"],"description":"The `name` of the company to filter by."},"company_id":{"type":"string","examples":["12345"],"description":"The `company_id` of the company to filter by."},"tag_id":{"type":"string","examples":["678910"],"description":"The `tag_id` of the company to filter by."},"segment_id":{"type":"string","examples":["98765"],"description":"The `segment_id` of the company to filter by."},"type":{"type":"string","enum":["user","users"],"examples":["users"],"description":"Set to `user` or `users`, together with `company_id` or `name`, to return that company's users instead of the company. The response is then a `user.list` object with a `users` array in the legacy user format, paged with `page` and `per_page` (default 50)."},"page":{"type":"integer","examples":[1],"description":"The page of results to fetch. Defaults to first page"},"per_page":{"type":"integer","maximum":60,"examples":[15],"description":"How many results to display per page. Defaults to 15. A value above 60 returns a `400` error with code `parameter_invalid`."}},"required":[],"additionalProperties":false}},"required":[],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["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","2.15","2.16","2.17"],"examples":["2.17"]}}},"name":"Retrieve companies","id":"intercom.retrievecompany","example":{},"maxRequests":1,"summary":false}}