---
title: "Count company user usage"
method: GET
path: "/user-usage-by-company/users/count"
tags: ["entitlements"]
---

# Count company user usage

`GET /user-usage-by-company/users/count`

## Query parameters

- `company_id` string, required — Company to break usage down for
- `end_time` string, date-time — End of the usage window (exclusive); defaults to now
- `feature_id` string — The event-based feature to break down; required when metric is feature
- `metric` 'credits' | 'feature', required
- `limit` integer — Page limit (default 100)
- `offset` integer — Page offset (default 0)
- `start_time` string, date-time — Start of the usage window; defaults to 30 days before the end

## Response `200`

OK

- object
  - `data` CountResponse, required
    - `count` integer — The number of resources
  - `params` object, required — Input parameters
    - `company_id` string — Company to break usage down for
    - `end_time` string, date-time — End of the usage window (exclusive); defaults to now
    - `feature_id` string — The event-based feature to break down; required when metric is feature
    - `limit` integer — Page limit (default 100)
    - `metric` 'credits' | 'feature'
    - `offset` integer — Page offset (default 0)
    - `start_time` string, date-time — Start of the usage window; defaults to 30 days before the end

## Other responses

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

## Changes

- **2026-09-28** `eb32b6d1c979` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/schematichq/apis/schematic-api/changes/user-usage-by-company/users/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.dev/schematichq/apis/schematic-api/revisions/2c923705baad?raw)