---
title: "Company owners across the firm"
method: GET
path: "/firm/company-owners"
tags: ["Firm"]
---

# Company owners across the firm

`GET /firm/company-owners`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/firm/company-owners`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Read-only firm staff lookup across every accessible client company. Owners are people with active client access or a pending invitation, as in /companies/{companyId}/owners. mine=true returns only companies where the signed-in user is a listed owner; owner filters by email or part of a name. Returns filter, companiesSearched, matchCount, companies (organizationId, companyName, owners with ownerId, name, email, status, inviteExpiresAt), and, without a filter, companiesWithoutOwners.

## Query parameters

- `mine` boolean
- `owner` string

## Response `200`

Companies and their listed owners

## Other responses

- `400`: Invalid parameters
- `403`: Firm staff access is required
- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)