Skip to content
Mengi CloudMengi Cloud Docs

Get Billing Status

GET
/billing/status
curl --request GET \
  --url https://api.mengi.cloud/billing/status

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.

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
organization_id
Any of:
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
BillingStatusResponse
object
has_subscription
required
Has Subscription
boolean
mandate_verified
required
Mandate Verified
boolean
credit_limit
required
Credit Limit
number
balance
required
Balance
number
available_credit
required
Available Credit
number
status
Any of:
string
payment_failures
Payment Failures
integer
0
suspended_at
Any of:
string format: date-time
current_period_usage
Current Period Usage
number
0
estimated_monthly_cost
Estimated Monthly Cost
number
0
trial_active
Trial Active
boolean
trial_credit_total
Trial Credit Total
number
0
trial_credit_remaining
Trial Credit Remaining
number
0
platform_fee_waived
Platform Fee Waived
boolean
deletion_scheduled_at
Any of:
string format: date-time
Example
{
  "payment_failures": 0,
  "current_period_usage": 0,
  "estimated_monthly_cost": 0,
  "trial_active": false,
  "trial_credit_total": 0,
  "trial_credit_remaining": 0,
  "platform_fee_waived": false
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}