---
title: "Read monthly measured usage by project and meter"
method: GET
path: "/v1/organizations/{organization_id}/credit-usage"
---

# Read monthly measured usage by project and meter

`GET /v1/organizations/{organization_id}/credit-usage`

## Request

- Base URL: `https://app.ohmyho.st`
- URL: `https://app.ohmyho.st/v1/organizations/{organization_id}/credit-usage`
- Auth: HTTP bearer

Owner-only event-month ledger totals, including signed corrections posted by as_of. Returns up to 20 projects per page in ID order; use next_cursor with the same month. Current unresolved reservations are separate from measured consumption. Null environment_id means project-shared cost, never guessed Dev allocation. Only posted measurements are included; this is not a complete provider invoice or zero-usage guarantee. Billing may arrive later. No credit is granted or charged by this read; it remains usable at zero credits.

## Path parameters

- `organization_id` string, required

## Query parameters

- `month` string, required
- `cursor` string

## Headers

- `X-Request-Id` string

## Response `200`

Current posted usage for the selected UTC month and project page.

- OrganizationCreditUsage
  - `organization_id` string, required
  - `month` string, required
  - `as_of` string, date-time, required
  - `unit` 'microcredits', required
  - `next_cursor` string, required
  - `data` object[], required
    - `project_id` string, required
    - `reserved_micros` string, required: Non-negative integer aggregate, serialized exactly without floating-point rounding.
    - `meters` object[], required
      - `environment_id` string, required
      - `meter` string, required
      - `unit` string, required
      - `rate_card_id` string, required
      - `quantity` string, required: Non-negative integer aggregate, serialized exactly without floating-point rounding.
      - `charged_micros` string, required: Non-negative integer aggregate, serialized exactly without floating-point rounding.
      - `funded_micros` string, required: Non-negative integer aggregate, serialized exactly without floating-point rounding.
      - `platform_overrun_micros` string, required: Non-negative integer aggregate, serialized exactly without floating-point rounding.

## Other responses

- `400`: The request failed.
- `401`: The request failed.
- `404`: The resource does not exist or is not visible to the authenticated principal.
- `429`: The request failed.
- `503`: The request failed.

---

[API](https://skmtc.dev/ohmyho/apis/ohmyho-st-api.md) · [All operations](https://skmtc.dev/ohmyho/apis/ohmyho-st-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ohmyho/apis/ohmyho-st-api/revisions/d069888c0017?raw)