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

# Get org credit rollup

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

## Request

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

Sums the org's credits and billing rows per `bucket` (`hour`, `day` or `week`, UTC; default `day`) and per value of one or two dimension keys (`group`, repeatable, default `product`), in the requested window (`filter[timestamp][gte]` to the exclusive `filter[timestamp][lt]`, at most 90 days and at most 14 with `bucket=hour`, the last 7 days when neither is given) and in the window of the same length just before it. An hour counts toward a window when it starts in it. `filter[dimension.<key>]` keeps the sets holding that entry: repeated for one key it matches any value, across keys every key must match. `filter[actionCode]` keeps one action code. A set without a group key reports it as null in `key`, labelled `unattributed`. `series` has one entry per group value, or pair of values, in the current window, the heaviest 50, each with one point per bucket the window touches, zeros included; `truncated` says more were cut. 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
- `bucket` union
  - 'hour'
  - 'day'
  - 'week'
- `group` union
  - string
  - string[]
- `filter[actionCode]` string

## 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-rollup', required
    - `attributes` object, required
      - `bucket` union, required
        - 'hour'
        - 'day'
        - 'week'
      - `group` string[], required
      - `current` object, required
        - `start` string, date-time, required
        - `end` string, date-time, required
        - `credits` number, required
        - `eventCount` integer, required
      - `previous` object, required
        - `start` string, date-time, required
        - `end` string, date-time, required
        - `credits` number, required
        - `eventCount` integer, required
      - `series` object[], required
        - `key` string[], required
        - `label` string, required
        - `points` object[], required
          - `bucket` string, date-time, required
          - `credits` number, required
          - `eventCount` integer, required
      - `truncated` boolean, 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/rollup/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)