---
title: "Read auto-recharge and the current payment handoff"
method: GET
path: "/v1/organizations/{organization_id}/billing/recharge"
---

# Read auto-recharge and the current payment handoff

`GET /v1/organizations/{organization_id}/billing/recharge`

## Request

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

Owner-only. Reads saved consent and gross UTC-month spending; a pending Stripe card setup may be resumed. No charge is initiated by reading. Private Stripe URLs must not be logged.

## Path parameters

- `organization_id` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Actual recharge settings; disabled by default.

- BillingRecharge
  - `organization_id` string, required
  - `portal_available` boolean, required: An existing customer in this billing account is ready for a hosted billing-portal handoff; this does not imply a paid subscription.
  - `enabled` boolean, required
  - `revision` integer, required
  - `status` 'off' | 'setup_required' | 'on' | 'payment_required' | 'monthly_limit' | 'needs_reconciliation' | 'tax_required', required
  - `monthly_limit_minor` integer, required
  - `spent_minor` integer, required
  - `currency` 'usd', required
  - `amount_minor` 900, required
  - `credits` 1000, required
  - `threshold_credits` 100, required
  - `setup_url` string, uri, nullable, required
  - `invoice_url` string, uri, nullable, required
  - `billing_issue` BillingTaxIssue, nullable, required: Verified issue on an existing Stripe invoice; no new purchase is needed.
    - `code` 'billing_tax_location_required' | 'billing_tax_calculation_failed' | 'billing_tax_configuration_required', required
    - `invoice_id` string, required
    - `observed_at` string, date-time, required
    - `required_action` 'open_billing_portal' | 'contact_support', 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)