Organizations & usage

What a namespace used, day by day

GET /api/v1/namespaces/{ns}/usage

Returns usage counters and the personal workspace's check summary. API requests and bytes, model checks and reserved traffic counters, for each UTC day, latest first. model_checks gives the personal workspace's current UTC month summary, cap and reset time; Free counts checks in Free workspaces across verified accounts sharing an inbox. It is null for organizations. Personal usage lists your checks this month in each workspace you belong to. People and their delegated keys read their own namespace; organization owners read their organization's use. Today's counts include the last minute.

Parameters

nspath · required · string: A person, such as john, or an organization, such as acme.
daysquery · optional · integer (int32): How many days back, up to 366; 30 when not given.

Example request

curl --request GET 'https://commitscale.com/api/v1/namespaces/alex/usage' \
  --header "Authorization: Bearer $CSCALE_CHECK_KEY"

Example values illustrate the format. Use your own credentials and identifiers.

Responses

200 Its days.

application/json

{
  "days": [
    {
      "api_out_bytes": 1,
      "api_requests": 1,
      "day": "2026-10-26",
      "git_in_bytes": 1,
      "git_ms": 1,
      "git_out_bytes": 1,
      "log_bytes": 1,
      "model_checks": 1,
      "repo_bytes": 1,
      "session_bytes": 1
    }
  ],
  "model_checks": {
    "cap": 100,
    "resets_at": "2026-11-01T00:00:00Z",
    "used": 12
  },
  "namespace": "alex"
}

daysrequired · array of object

The latest day first. A day with no use has no entry.

Fields of days

The latest day first. A day with no use has no entry.

Each item has this shape.

One UTC day of a namespace's use. Counts from the current day grow until it ends.

api_out_bytesrequired · integer (int64): Bytes sent in API responses for this UTC day.
api_requestsrequired · integer (int64): API requests attributed to this key or namespace, including failed requests.
dayrequired · string (date): UTC calendar date in YYYY-MM-DD form.
git_in_bytesrequired · integer (int64): Reserved traffic measurement.
git_msrequired · integer (int64): Reserved traffic measurement.
git_out_bytesrequired · integer (int64): Reserved traffic measurement.
log_bytesrequired · integer or null (int64): Reserved storage measurement; null until measured.
model_checksrequired · integer (int64): Checks counted against this workspace on this UTC day.
repo_bytesrequired · integer or null (int64): Reserved storage measurement; null until measured.
session_bytesrequired · integer or null (int64): Reserved storage measurement; null until measured.

model_checksrequired · null or object

This month's allowance for the personal workspace. Free counts checks in Free workspaces across verified accounts sharing a mailbox. Null for organizations.

Fields of model_checks

One of these shapes

May be null.

The current UTC month's check allowance for a personal workspace.

caprequired · integer or null (int64): 100 on Free; null on plans without a monthly cap.
resets_atrequired · string (date-time): The start of the next UTC calendar month.
usedrequired · integer (int64): Checks this month in Free workspaces sharing the verified mailbox, or this personal workspace's checks when its plan is not Free. Retries do not count again.

namespacerequired · string

The personal or organization namespace name.

workspacesoptional · array of object

Your checks this month in each workspace you belong to. Omitted for other namespaces.

Fields of workspaces

Your checks this month in each workspace you belong to. Omitted for other namespaces.

Each item has this shape.

checksrequired · integer (int64): Your checks started in this workspace during the current UTC month.
namespacerequired · string: Workspace namespace name.
planrequired · string: The workspace's effective plan.

RateLimit and RateLimit-Policy describe the request rate. Follow Retry-After when a response asks you to wait.

Problem responses

Errors use application/problem+json. Act on the stable code, and follow next when present. See the problem format.

check_key_scope403

A check-only key may call the test check, read its own usage and acceptance rule, contact support, and withdraw data sharing.

Use a person's sign-in for account management. More agent power needs the owner's passkey; this key cannot widen itself.

feature_off403

The namespace plan does not include this feature.

Retrying on the same plan will not help. GET /api/v1/namespaces/{namespace}/plan, and the namespace's Plan page in Settings, show what its plan includes.

unauthenticated401

The request carried no credentials.

Use this operation's sign-in method. Bearer credentials use Authorization: Bearer <token>; browser credentials use the session cookie.

invalid_token401

The token is unknown, expired, or revoked, its agent was revoked, or an OAuth token was used outside its MCP resource.

Stop using it. Sign in again, or ask the owner to create a replacement agent key.

forbidden403

The caller may not do this: only people may, only owners may, or the agent was not given this repository or write access.

Stop. Retrying will not help. Ask the owner for the access, or leave the step to a person.

not_found404

It does not exist, or the caller cannot read it: a repository the caller cannot read is reported as not found.

Check the name or ID, and that the token has the repository.

invalid_request400

The request is malformed or breaks a rule, such as a title that is too long, or a body that is not the expected JSON.

Fix the request as detail says. The same request fails the same way.

quota_exceeded429

With 429, the caller used its requests for the minute. With 422, a count limit was reached.

With 429, wait Retry-After seconds and retry. With 422, remove one first.

internal500

The server failed, and logged why.

Retry after Retry-After seconds. A write is safe to retry with the same idempotency key.