---
title: "Get team usage"
method: GET
path: "/v1/teams/{teamId}/usage"
tags: ["Teams"]
---

# Get team usage

`GET /v1/teams/{teamId}/usage`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/teams/{teamId}/usage`
- Auth: HTTP bearer

Returns the team's current usage counters: spaces, domains, members, storage, and monthly publishes.

## Path parameters

- `teamId` string, required

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `teamId` string, required: The team id the usage was metered for.
    - `usage` object, required: Usage counters against the named plan limits.
      - `spaces` integer, required: Live spaces readable by the caller.
      - `liveSpaces` integer, required: Team-wide live Space count used for the plan quota.
      - `domains` integer, required: Custom domains the team has in inventory.
      - `members` integer, required: Team members.
      - `storageBytes` number, required: Disk occupied across the team's spaces, as measured by the serving infrastructure. Nothing is deduplicated: a file present in two spaces sits on two disks and counts twice.
      - `storageQuotaBytes` union, required: Plan storage quota; "unlimited" when unbounded.
        - number
        - 'unlimited'
      - `storageOverageBytes` number, required: Bytes over the plan storage quota.
      - `storageCalculatedAt` string, nullable, required: How far back the weakest measurement behind this total reaches. Null when the team's storage has not been measured yet. The meter lags the present by about an hour.
      - `buildsDeploysToday` integer, required: Publishes (user pushes and CI builds pooled) in the current UTC day.
      - `buildsDeploysDaily` union, required: Daily publish allowance for the plan. Passing it warns; it never blocks.
        - integer
        - 'unlimited'
      - `buildsDeploysThisMonth` integer
      - `buildsDeploysMonthly` union: Plan limit value; "unlimited" when the plan does not limit this axis.
        - integer
        - 'unlimited'
      - `meterStartedAt` string, nullable, required: Instant when the current metering day started.
    - `spaceStorage` object[], required: Per-space storage breakdown for spaces the caller can read.
      - `spaceId` string, required: Space id.
      - `slug` string, required: Space slug.
      - `title` string, required: Space display title.
      - `storageBytes` number, required: Disk this space occupies, as measured by the infrastructure serving it. Zero until the space has been measured.

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)