---
title: "Get companies"
method: GET
path: "/api/v2/companies"
tags: ["Companies"]
---

# Get companies

`GET /api/v2/companies`

List companies with optional filters and pagination.

## Query parameters

- `filter` union — Filter schema for `company` list endpoints — pass a single condition or a logical group.
  - FilterCompany — Filter parameters for companies (clients).
    - `default_subsidiary_id` union — Filter by the company's default subsidiary.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` DefaultSubsidiaryId — unresolved $ref
        - `not_contain` DefaultSubsidiaryId — unresolved $ref
        - `eq` DefaultSubsidiaryId — unresolved $ref
        - `contains` DefaultSubsidiaryId — unresolved $ref
      - DefaultSubsidiaryId — unresolved $ref
    - `due_days` union — Filter by default payment terms (days).
      - DueDays — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` DueDays — unresolved $ref
        - `contains` DueDays — unresolved $ref
        - `not_contain` DueDays — unresolved $ref
        - `eq` DueDays — unresolved $ref
    - `query` union — Search companies by name (text search).
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` Query — unresolved $ref
        - `not_contain` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
        - `contains` Query — unresolved $ref
      - Query — unresolved $ref
    - `exclude_company_and_children` union — Filter by excluding a company and all its subsidiaries from results.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` ExcludeCompanyAndChildren — unresolved $ref
        - `not_contain` ExcludeCompanyAndChildren — unresolved $ref
        - `eq` ExcludeCompanyAndChildren — unresolved $ref
        - `not_eq` ExcludeCompanyAndChildren — unresolved $ref
      - ExcludeCompanyAndChildren — unresolved $ref
    - `vat` union — Filter by VAT / tax ID number.
      - Vat — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_contain` Vat — unresolved $ref
        - `contains` Vat — unresolved $ref
        - `eq` Vat — unresolved $ref
        - `not_eq` Vat — unresolved $ref
    - `subscriber_id` union — Filter by subscriber (person subscribed to company notifications).
      - SubscriberId — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` SubscriberId — unresolved $ref
        - `not_contain` SubscriberId — unresolved $ref
        - `eq` SubscriberId — unresolved $ref
        - `contains` SubscriberId — unresolved $ref
    - `company_code` union — Filter by company code (text search).
      - CompanyCode — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_contain` CompanyCode — unresolved $ref
        - `not_eq` CompanyCode — unresolved $ref
        - `contains` CompanyCode — unresolved $ref
        - `eq` CompanyCode — unresolved $ref
    - `default_tax_rate_id` union — Filter by the company's default tax rate.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` DefaultTaxRateId — unresolved $ref
        - `not_contain` DefaultTaxRateId — unresolved $ref
        - `eq` DefaultTaxRateId — unresolved $ref
        - `contains` DefaultTaxRateId — unresolved $ref
      - DefaultTaxRateId — unresolved $ref
    - `jump_query` union — Quick search query for jumping to a specific company by name.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` JumpQuery — unresolved $ref
        - `eq` JumpQuery — unresolved $ref
        - `not_contain` JumpQuery — unresolved $ref
        - `contains` JumpQuery — unresolved $ref
      - JumpQuery — unresolved $ref
    - `created_at` union — Filter by creation date range (`created_at`).
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` CreatedAt — unresolved $ref
        - `not_eq` CreatedAt — unresolved $ref
        - `contains` CreatedAt — unresolved $ref
        - `not_contain` CreatedAt — unresolved $ref
      - CreatedAt — unresolved $ref
    - `full_query` union — Full-text search across company name, billing name, and other text fields.
      - FullQuery — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_contain` FullQuery — unresolved $ref
        - `contains` FullQuery — unresolved $ref
        - `eq` FullQuery — unresolved $ref
        - `not_eq` FullQuery — unresolved $ref
    - `fuzzy_dates` union — Filter by fuzzy date range (e.g. this_week, last_month).
      - FuzzyDates — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` FuzzyDates — unresolved $ref
        - `not_eq` FuzzyDates — unresolved $ref
    - `tags` union — Filter by tag.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` Tags — unresolved $ref
        - `not_contain` Tags — unresolved $ref
        - `eq` Tags — unresolved $ref
        - `contains` Tags — unresolved $ref
      - Tags — unresolved $ref
    - `archived_at` union — Filter by archive date range (`archived_at`).
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` ArchivedAt — unresolved $ref
        - `not_eq` ArchivedAt — unresolved $ref
        - `not_contain` ArchivedAt — unresolved $ref
        - `eq` ArchivedAt — unresolved $ref
      - ArchivedAt — unresolved $ref
    - `has_parent_company` union — Filter by whether the company has a parent company assigned.
      - HasParentCompany — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` HasParentCompany — unresolved $ref
        - `not_contain` HasParentCompany — unresolved $ref
        - `eq` HasParentCompany — unresolved $ref
        - `contains` HasParentCompany — unresolved $ref
    - `status` union — Filter by company status (active or archived).
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` Status — unresolved $ref
        - `eq` Status — unresolved $ref
        - `not_contain` Status — unresolved $ref
        - `contains` Status — unresolved $ref
      - Status — unresolved $ref
    - `project_id` union — Filter by companies associated with a project.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
        - `not_eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
      - ProjectId — unresolved $ref
    - `fuzzy_people` union — Filter by person using fuzzy matching.
      - FuzzyPeople — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` FuzzyPeople — unresolved $ref
        - `not_eq` FuzzyPeople — unresolved $ref
        - `contains` FuzzyPeople — unresolved $ref
        - `not_contain` FuzzyPeople — unresolved $ref
    - `default_currency` union — Filter by the company's default invoice currency.
      - DefaultCurrency — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_contain` DefaultCurrency — unresolved $ref
        - `not_eq` DefaultCurrency — unresolved $ref
        - `contains` DefaultCurrency — unresolved $ref
        - `eq` DefaultCurrency — unresolved $ref
    - `name` union — Filter by company name (text search).
      - Name — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` Name — unresolved $ref
        - `not_eq` Name — unresolved $ref
        - `not_contain` Name — unresolved $ref
        - `eq` Name — unresolved $ref
    - `last_activity_at` union — Filter by last activity date range (`last_activity_at`).
      - LastActivityAt — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` LastActivityAt — unresolved $ref
        - `not_eq` LastActivityAt — unresolved $ref
        - `contains` LastActivityAt — unresolved $ref
        - `not_contain` LastActivityAt — unresolved $ref
    - `billing_name` union — Filter by billing name (full legal company name).
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_contain` BillingName — unresolved $ref
        - `contains` BillingName — unresolved $ref
        - `eq` BillingName — unresolved $ref
        - `not_eq` BillingName — unresolved $ref
      - BillingName — unresolved $ref
    - `subsidiary_id` union — Filter by the company's subsidiary (alias for `default_subsidiary_id`).
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` SubsidiaryId — unresolved $ref
        - `not_contain` SubsidiaryId — unresolved $ref
        - `not_eq` SubsidiaryId — unresolved $ref
        - `eq` SubsidiaryId — unresolved $ref
      - SubsidiaryId — unresolved $ref
    - `custom_fields` union — Filter by custom field values.
      - CustomFields — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` CustomFields — unresolved $ref
        - `contains` CustomFields — unresolved $ref
        - `eq` CustomFields — unresolved $ref
        - `not_contain` CustomFields — unresolved $ref
    - `payment_terms` union — Filter by payment terms (days until invoice due).
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` PaymentTerms — unresolved $ref
        - `not_contain` PaymentTerms — unresolved $ref
        - `not_eq` PaymentTerms — unresolved $ref
        - `eq` PaymentTerms — unresolved $ref
      - PaymentTerms — unresolved $ref
    - `payment_terms_type` union
      - PaymentTermsType — unresolved $ref
      - object
        - `eq` PaymentTermsType — unresolved $ref
        - `not_eq` PaymentTermsType — unresolved $ref
        - `not_contain` PaymentTermsType — unresolved $ref
        - `contains` PaymentTermsType — unresolved $ref
    - `parent_company_id` union — Filter by the parent company of the company.
      - ParentCompanyId — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` ParentCompanyId — unresolved $ref
        - `not_eq` ParentCompanyId — unresolved $ref
        - `not_contain` ParentCompanyId — unresolved $ref
        - `contains` ParentCompanyId — unresolved $ref
    - `company_id` union — Filter by company ID (alias for `id`).
      - CompanyId — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_contain` CompanyId — unresolved $ref
        - `contains` CompanyId — unresolved $ref
        - `eq` CompanyId — unresolved $ref
        - `not_eq` CompanyId — unresolved $ref
    - `id` union — Filter by company ID.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
        - `eq` Id — unresolved $ref
      - Id — unresolved $ref
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection company

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/11e8576224b8/schema)