---
title: "Get Billing Status"
method: GET
path: "/billing/status"
tags: ["billing"]
---

# Get Billing Status

`GET /billing/status`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/billing/status`
- Auth: none declared

Get current billing status including mandate verification, credit limit, and usage.

With ``organization_id`` this returns the organization's billing status
(requires membership); otherwise the user's personal one.

## Query parameters

- `organization_id` string, nullable

## Response `200`

Successful Response

- BillingStatusResponse
  - `has_subscription` boolean, required
  - `mandate_verified` boolean, required
  - `credit_limit` number, required
  - `balance` number, required
  - `available_credit` number, required
  - `status` string, nullable
  - `payment_failures` integer
  - `suspended_at` string, date-time, nullable
  - `current_period_usage` number
  - `estimated_monthly_cost` number
  - `trial_active` boolean
  - `trial_credit_total` number
  - `trial_credit_remaining` number
  - `platform_fee_waived` boolean
  - `deletion_scheduled_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/4ae9b375cdbb?raw)