---
title: "Read a project's optional monthly credit budget"
method: GET
path: "/v1/projects/{project_id}/credit-budget"
---

# Read a project's optional monthly credit budget

`GET /v1/projects/{project_id}/credit-budget`

## Request

- Base URL: `https://app.ohmyho.st`
- URL: `https://app.ohmyho.st/v1/projects/{project_id}/credit-budget`
- Auth: HTTP bearer

Owner-only snapshot of UTC-calendar-month measured usage and all open reservations. No budget means shared organization funds; continue mode does not stop at the threshold.

## Path parameters

- `project_id` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Current project budget and recorded usage.

- ProjectCreditBudget
  - `project_id` string, required
  - `amount_micros` string, required: Non-negative microcredits, at most 9223372036854775807. One credit equals 1000000 microcredits.
  - `mode` 'continue' | 'stop', required
  - `used_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.
  - `period_start` string, date-time, required
  - `period_end` string, date-time, required
  - `as_of` string, date-time, required

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