---
title: "Count companies"
method: GET
path: "/companies/count"
tags: ["companies"]
---

# Count companies

`GET /companies/count`

## Query parameters

- `credit_type_ids` string[] — Filter companies by one or more credit type IDs (each ID starts with bcrd_)
- `has_scheduled_downgrade` boolean — Filter companies that have a pending scheduled downgrade
- `ids` string[] — Filter companies by multiple company IDs (starts with comp_)
- `monetized_subscriptions` boolean — Filter companies that have monetized subscriptions
- `plan_id` string — Filter companies by plan ID (starts with plan_)
- `plan_ids` string[] — Filter companies by one or more plan IDs (each ID starts with plan_)
- `plan_version_id` string — Filter companies by plan version ID (starts with plvr_)
- `plan_version_ids` string[] — Filter companies by one or more plan version IDs (each ID starts with plvr_). Takes precedence over plan_version_id when set.
- `plan_version_unpublished` boolean — Filter companies assigned to a plan version that is no longer published, meaning the plan has since moved on to a newer version
- `q` string — Search for companies by name, keys or string traits
- `sort_order_column` string — Column to sort by (e.g. name, created_at, last_seen_at)
- `sort_order_direction` 'asc' | 'desc'
- `subscription_statuses` SubscriptionStatus[] — Filter companies by one or more subscription statuses
- `subscription_types` SubscriptionType[] — Filter companies by one or more subscription types
- `with_entitlement_for` string — Filter companies that have an entitlement (plan entitlement or company override) for the specified feature ID
- `without_feature_override_for` string — Filter out companies that already have a company override for the specified feature ID
- `without_plan` boolean — Filter out companies that have a plan
- `without_subscription` boolean — Filter out companies that have a subscription
- `with_subscription` boolean — Filter companies that have a subscription
- `limit` integer — Page limit (default 100)
- `offset` integer — Page offset (default 0)

## Response `200`

OK

- object
  - `data` CountResponse, required
    - `count` integer — The number of resources
  - `params` object, required — Input parameters
    - `credit_type_ids` string[] — Filter companies by one or more credit type IDs (each ID starts with bcrd_)
    - `has_scheduled_downgrade` boolean — Filter companies that have a pending scheduled downgrade
    - `ids` string[] — Filter companies by multiple company IDs (starts with comp_)
    - `limit` integer — Page limit (default 100)
    - `monetized_subscriptions` boolean — Filter companies that have monetized subscriptions
    - `offset` integer — Page offset (default 0)
    - `plan_id` string — Filter companies by plan ID (starts with plan_)
    - `plan_ids` string[] — Filter companies by one or more plan IDs (each ID starts with plan_)
    - `plan_version_id` string — Filter companies by plan version ID (starts with plvr_)
    - `plan_version_ids` string[] — Filter companies by one or more plan version IDs (each ID starts with plvr_). Takes precedence over plan_version_id when set.
    - `plan_version_unpublished` boolean — Filter companies assigned to a plan version that is no longer published, meaning the plan has since moved on to a newer version
    - `q` string — Search for companies by name, keys or string traits
    - `sort_order_column` string — Column to sort by (e.g. name, created_at, last_seen_at)
    - `sort_order_direction` 'asc' | 'desc'
    - `subscription_statuses` SubscriptionStatus[] — Filter companies by one or more subscription statuses
    - `subscription_types` SubscriptionType[] — Filter companies by one or more subscription types
    - `with_entitlement_for` string — Filter companies that have an entitlement (plan entitlement or company override) for the specified feature ID
    - `with_subscription` boolean — Filter companies that have a subscription
    - `without_feature_override_for` string — Filter out companies that already have a company override for the specified feature ID
    - `without_plan` boolean — Filter out companies that have a plan
    - `without_subscription` boolean — Filter out companies that have a subscription

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Server error

## Changes

> 125 revisions in range; 16 could not be searched.

- **2026-08-18** `7e949606866d` — 2 info
  - added the new optional `query` request parameter `plan_version_unpublished`
  - added the optional property `params/plan_version_unpublished` to the response with the `200` status
- **2026-07-15** `3baa54bf8b3f` — 2 warning
  - for the `query` request parameter `limit`, the max was set to `250.00`
  - for the `query` request parameter `limit`, the min was set to `0.00`
- **2026-05-27** `b059af8ebdc0` — 2 info
  - added the new optional `query` request parameter `plan_version_ids`
  - added the optional property `params/plan_version_ids` to the response with the `200` status

[Change history](https://skmtc.dev/schematichq/apis/schematic-api/changes/companies/count/get.md)

---

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