---
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

---

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