---
title: "Get organization billing state"
method: GET
path: "/orgs/v1/{org_id}/billing"
tags: ["Billing"]
---

# Get organization billing state

`GET /orgs/v1/{org_id}/billing`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/orgs/v1/{org_id}/billing`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer
  - API key in header `x-admin-key`

Returns balance, tier, lease expiry, and auto-recharge config for an organization. Requires an admin key or an authenticated SIWX/control-plane-session principal with an active org role of billing or higher.

## Path parameters

- `org_id` string, required

## Response `200`

Organization billing state

- object
  - `org_id` string, required
  - `allowance_usd_micros` integer, required
  - `email_credits_remaining` integer, required
  - `tier` unknown, required
  - `lease_expires_at` string, date-time, required
  - `auto_recharge_enabled` boolean, required
  - `auto_recharge_threshold` integer, required

## Other responses

- `401`: Missing or invalid SIWX/control-plane-session credential (and no admin key)
- `403`: Active organization role of billing or higher required

---

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