---
title: "List org credit dimensions"
method: GET
path: "/experimental/orgs/{orgId}/credits/dimensions"
tags: ["Orgs"]
---

# List org credit dimensions

`GET /experimental/orgs/{orgId}/credits/dimensions`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/experimental/orgs/{orgId}/credits/dimensions`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tessl/apis/tessl-api/docs/experimental/orgs/:orgId/credits/dimensions/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists every dimension key the org's credits carried in the requested window (`filter[timestamp][gte]` to the exclusive `filter[timestamp][lt]`, at most 90 days, the last 7 days when neither is given), heaviest first, with the credits that carried it and its distinct values, heaviest first and at most 200; `truncated` says more were cut. `label` and `description` name a known key, and a value's `label` names the Loop or project its id points at; both are null when there is nothing to add to the raw key or value. Requires permission to manage the org's billing.

## 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-credit-dimensions', required
    - `attributes` object, required
      - `start` string, date-time, required
      - `end` string, date-time, required
      - `dimensions` object[], required
        - `key` string, required
        - `label` string, nullable, required
        - `description` string, nullable, required
        - `credits` number, required
        - `truncated` boolean, required
        - `values` object[], required
          - `value` string, required
          - `label` string, nullable, required
          - `credits` number, required

## Other responses

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

## Changes

- **2026-11-06** `de4ee98f763e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/credits/dimensions/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.dev/tessl/apis/tessl-api/revisions/3fb56359f347?raw)