---
title: "Crbon Labs' own AI usage footprint"
method: GET
path: "/api/v1/public/usage/crbonlabs"
tags: ["Usage"]
---

# Crbon Labs' own AI usage footprint

`GET /api/v1/public/usage/crbonlabs`

## Request

- Base URL: `https://api.crbonfree.com`
- URL: `https://api.crbonfree.com/api/v1/public/usage/crbonlabs`
- Auth: none required
- TypeScript: <https://skmtc.dev/crbonfree/apis/crbonfree-api/docs/api/v1/public/usage/crbonlabs/get.ts> (a function with typed inputs; its response is checked against the schema)

Aggregate AI usage and emissions for Crbon Labs Inc.'s own organisation over a trailing window — the same numbers the product dashboard shows, to the token. Aggregates only: no events, users, keys, connections or cost. No auth required — powers the public landing and case study. Cached for 30 minutes; `computedAt` is when the payload was computed.

## Query parameters

- `range` '7d' | '30d' | '90d' | '365d': Trailing window in UTC days — the same presets GET /api/v1/usage/summary accepts.

## Response `200`

Showcase usage

- object
  - `success` true, required
  - `data` PublicShowcaseUsage, required
    - `range` object, required
      - `start` string, required
      - `end` string, required
    - `totals` object, required
      - `totalTokens` number, required
      - `inputTokens` number, required: Uncached + cached + cache-creation input tokens.
      - `outputTokens` number, required
      - `requestCount` number, required
      - `carbonKg` number, required
      - `electricityKwh` number, required
      - `waterLiters` number, required: Estimated water footprint in liters. ESTIMATE ONLY.
      - `waterLowerBoundL` number, required: Lower uncertainty bound of the water estimate (liters).
      - `waterUpperBoundL` number, required: Upper uncertainty bound of the water estimate (liters).
    - `avgDailyTokens` number, required: totalTokens over the number of days in the range.
    - `daily` object[], required
      - `date` string, required: UTC day, YYYY-MM-DD.
      - `totalTokens` number, required
      - `inputTokens` number, required
      - `outputTokens` number, required
      - `carbonKg` number, required
      - `electricityKwh` number, required
      - `waterLiters` number, required
    - `byProvider` object[], required
      - `provider` string, required
      - `totalTokens` number, required
      - `pct` number, required: Share of the range totalTokens, one decimal, 0–100.
    - `methodology` object, required
      - `factorsVersion` string, required
      - `framework` string, required
    - `computedAt` string, required: ISO-8601; when the backend computed this payload.

## Other responses

- `400`: Bad request — validation failed or malformed JSON body
- `401`: Unauthorized — token missing, expired, or invalid
- `429`: Too many requests — rate limit exceeded
- `500`: Internal server error
- `503`: Not available — showcase organisation not configured, or the OpenRouter dataset has not been synced yet

## Changes

- **2026-09-10** `c012db361335`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crbonfree/apis/crbonfree-api/changes/api/v1/public/usage/crbonlabs/get.md)

---

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