---
title: "GET /experimental/orgs/{orgId}/insights"
method: GET
path: "/experimental/orgs/{orgId}/insights"
tags: ["Orgs"]
---

# GET /experimental/orgs/{orgId}/insights

`GET /experimental/orgs/{orgId}/insights`

Org-wide credit usage broken down by category, workspace and user, over the requested range or the org's current billing window when none is given. Backs the org Usage page. Shape will evolve while this lives under /experimental.

## Path parameters

- `orgId` string, uuid, required

## Query parameters

- `filter[timestamp][gte]` string, date-time
- `filter[timestamp][lt]` string, date-time

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'org-insights', required
    - `attributes` object, required
      - `window` object, required
        - `creditsSince` string, date-time, required
        - `creditsBefore` string, date-time, nullable, required
        - `isBillingPeriod` boolean, required
      - `credits` union, required
        - object
          - `state` union, required
            - 'ok'
            - 'over_budget'
          - `limit` number, required
          - `used` number, required
          - `remaining` number, required
          - `windowStart` string, date-time, nullable, required
          - `resetsAt` string, date-time, nullable, required
          - `overLimit` boolean, required
          - `blocked` boolean, required
          - `overageAllowed` boolean, required
        - object
          - `state` 'unlimited', required
        - object
          - `state` 'unavailable', required
      - `usageByCategory` object[], required
        - `category` union, required
          - 'generation'
          - 'tests_reviews'
          - 'task_evaluations'
          - 'analysis'
          - 'mcp'
          - 'launch'
          - 'inference'
        - `totalCredits` number, required
      - `creditsByWorkspace` object, nullable, required
        - `rows` object[], required
          - `workspaceId` string, nullable, required
          - `name` string, nullable, required
          - `totalCredits` number, required
        - `other` object, nullable, required
          - `groups` integer, required
          - `totalCredits` number, required
      - `spendByUser` object, nullable, required
        - `rows` object[], required
          - `userId` string, nullable, required
          - `username` string, nullable, required
          - `totalCredits` number, required
        - `other` object, nullable, required
          - `groups` integer, required
          - `totalCredits` number, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-08-21** `94ea3c4ec562` — 8 breaking, 4 info
  - removed the required property `data/attributes/activeUsers` from the response with the `200` status
  - removed the required property `data/attributes/installs` from the response with the `200` status
  - removed the required property `data/attributes/publishes` from the response with the `200` status
  - removed the required property `data/attributes/repos` from the response with the `200` status
  - …8 more
- **2026-08-20** `cfc6292039de` — 2 info
  - added the required property `data/attributes/installs` to the response with the `200` status
  - added the required property `data/attributes/window/installsThrough` to the response with the `200` status
- **2026-08-14** `97cba54605fd` — 1 info
  - added the required property `data/attributes/activeUsers` to the response with the `200` status
- **2026-08-13** `9be5c2a862b7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/insights/get.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tessl/tessl-api/revisions/62bb86f8aa90/schema)