---
title: "Get companies"
method: GET
path: "/public/v1/companies"
tags: ["Company"]
---

# Get companies

`GET /public/v1/companies`

List the companies in your CRM (each entry is your relationship with another company), ordered oldest-first by creation date. Filter by name or legal business name, business category, relationship type, group, owner, license number, US state or city, QuickBooks Online / LeafLink links, outstanding balance, custom fields, creation and last-modified datetimes, and whether soft-deleted entries are included.

This is a read-only listing served from a replica, so it returns eventually consistent data — a create or update made through the API can take up to 1 second to appear here.

Required permission: `companies_permissions_view`. Results are scoped to your own account and further limited to the companies the authenticated user can see under their team restrictions, so this may return fewer entries than exist on the account.

## Query parameters

- `ids` string[]
- `category` 'Cultivator' | 'Delivery' | 'Dispensary' | 'Distributor' | 'Lab' | 'Manufacturer' | 'Microbusiness' | 'Other' | 'Retail'
- `inserted_datetime` string
- `deleted` 'no' | 'include' | 'only'
- `page` string
- `updated_datetime` string
- `name` string
- `names` string[]
- `legal_business_name` string
- `license_number` string
- `relationship_type_ids` string[]
- `company_group_ids` string[]
- `owner_ids` string[]
- `states` string[]
- `city` string
- `leaflink_customer_ids` integer[]
- `qb_customer_ids` string[]
- `qb_vendor_ids` string[]
- `has_outstanding_balance` boolean
- `outstanding_balance` string
- `custom_data` object

## Response `200`

A list of companies

## 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)