---
title: "Retrieves the collection of Company resources."
method: GET
path: "/companies"
tags: ["Company"]
---

# Retrieves the collection of Company resources.

`GET /companies`

## Request

- Base URL: `https://example.myintranetapps.com/api`
- URL: `https://example.myintranetapps.com/api/companies`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/bossinsights/apis/boss-insights/docs/companies/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the collection of Company resources.

## Query parameters

- `page` integer
- `itemsPerPage` integer

## Response `200`

Company collection

- Company[]
  - `id` string
  - `integration` string: The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string: Unique identifier for the company
  - `name` string: Company name
  - `isActive` boolean, nullable: A boolean indicating whether the company is active or not
  - `url` string, nullable: The web address of the company

---

[API](https://skmtc.dev/bossinsights/apis/boss-insights.md) - [All operations](https://skmtc.dev/bossinsights/apis/boss-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/bossinsights/apis/boss-insights/revisions/d08a107895ad?raw)