---
title: "Get CU usage"
method: GET
path: "/v1/organizations/{orgId}/cu/usage"
tags: ["CU"]
---

# Get CU usage

`GET /v1/organizations/{orgId}/cu/usage`

Get CU usage breakdown for a specific month

## Path parameters

- `orgId` string, required

## Query parameters

- `yearMonth` string, required

## Request body

- object

## Response `200`

OK

- GetCUUsageSuccessResponse
  - `code` integer
  - `data` CUUsageSummary
    - `daily` CUDailyUsage[]
      - `breakdown` CUUsageBreakdown[]
        - `count` integer
        - `cu` number
        - `nodeType` string
        - `type` string — "trigger" or "action"
      - `date` string
      - `used` number
    - `summary` CUUsageSummaryTotals
      - `adjusted` number — Net of period adjustments (credit +, debit -, incl. monthly reset) so the breakdown reconciles: granted + deposited + adjusted - used.
      - `deposited` number
      - `granted` number
      - `used` number
    - `yearMonth` string
  - `message` string
  - `requestId` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

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