---
title: "Read the owner's shared organization credit pool"
method: GET
path: "/v1/organizations/{organization_id}/credits"
---

# Read the owner's shared organization credit pool

`GET /v1/organizations/{organization_id}/credits`

## Request

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

Returns posted credits and reservations, in microcredits (one credit is 1000000 microcredits). Monthly entitlement posting is idempotent. Only the organization Owner may read this balance. active_meters names the currently billed sources; unreported usage is not included. platform_overrun_micros is recorded platform exposure, not customer debt. Remains available at zero credit.

## Path parameters

- `organization_id` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Current organization credit balance.

- OrganizationCredits
  - `organization_id` string, required
  - `unit` 'microcredits', required
  - `as_of` string, date-time, required
  - `available_micros` string, required: Non-negative microcredits, at most 9223372036854775807. One credit equals 1000000 microcredits.
  - `reserved_micros` string, required: Non-negative microcredits, at most 9223372036854775807. One credit equals 1000000 microcredits.
  - `spent_micros` string, required: Non-negative microcredits, at most 9223372036854775807. One credit equals 1000000 microcredits.
  - `expired_micros` string, required: Non-negative microcredits, at most 9223372036854775807. One credit equals 1000000 microcredits.
  - `platform_overrun_micros` string, required: Non-negative microcredits, at most 9223372036854775807. One credit equals 1000000 microcredits.
  - `grace_started_at` string, date-time, nullable, required: First confirmed exhaustion in this continuous period; null while funded.
  - `grace_expires_at` string, date-time, nullable, required: Seven days after first confirmed exhaustion. Existing services and domains are retained during this grace; no automatic data deletion. Explicit project stop budgets are separate.
  - `active_meters` string[], required
  - `rate_cards` PublishedCreditRateCard[], required: Published integer prices, newest first. A published rate is not proof of enabled billing; only active_meters names currently billed sources. Builds retain their accepted quote. Provider cost is a list-price basis before platform allowances, not an invoice.
    - `id` string, required
    - `currency` 'USD', required
    - `published_at` string, date-time, required
    - `effective_from` string, date-time, required
    - `rates` object[], required
      - `meter` string, required
      - `unit` string, required
      - `units_per_charge` string, required
      - `provider_cost_micros` string, required: Provider list-cost basis for units_per_charge, in USD micro-units (1000000 equals 1 USD), before shared allowances and discounts.
      - `credit_micros` string, required: Non-negative microcredits, at most 9223372036854775807. One credit equals 1000000 microcredits.

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