---
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.
- `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.
    - `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

---

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