---
title: "Get company groups"
method: GET
path: "/public/v1/company-groups"
tags: ["CompanyGroup"]
---

# Get company groups

`GET /public/v1/company-groups`

Lists the company groups owned by the authenticated company. Company groups are the labels you
use to organize your business relationships (your customers and vendors) — for example
"Wholesale", "Retail", or a region — and price tiers can target or exclude companies by group.

Results are scoped to your company only; groups belonging to other companies are never returned.
They come back sorted by creation time, oldest first, and are paginated: read `next_page` from the
envelope and request that URL to fetch the following page (it is null on the last page).

Required permission: `settings_permissions_company_relationship_groups`.

## Query parameters

- `ids` string[]
- `inserted_datetime` string
- `updated_datetime` string
- `page` string

## Response `200`

A list of company groups

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/f8930b2c2924/schema)