Skip to content
Hayonix

API reference · Schema

BillingAccount

  • objectstringrequired

    Always `billing_account`: the type of this object

    One ofbilling_account

  • org_idstringrequired

    Organization it belongs to

    ID with prefix org_

  • statusstringrequired

    `active`, or `suspended` by the platform: nothing can be launched, running compute is stopped (volumes kept) and API requests that spend credit are refused

    One ofactivesuspended

  • suspended_reasonstring | nullrequired

    Why the account was suspended; null while it is active

  • paidstringrequired

    Integer nano-USD as a decimal string

    pattern ^-?[0-9]+$

  • promostringrequired

    Integer nano-USD as a decimal string

    pattern ^-?[0-9]+$

  • heldstringrequired

    Integer nano-USD as a decimal string

    pattern ^-?[0-9]+$

  • availablestringrequired

    Integer nano-USD as a decimal string

    pattern ^-?[0-9]+$

  • out_of_creditbooleanrequired

    available ≤ 0: new launches and API requests are refused

  • compute_stops_atstring (date-time) | nullrequired

    When running compute will be stopped if no credit arrives

  • compute_stopped_atstring (date-time) | nullrequired

    Time compute stopped (ISO 8601, UTC)

  • compute_stop_reasonstring | nullrequired

    Why running compute was stopped: `zero_balance` (out of credit past the grace period), `overdraft_limit`, `spend_limit_hourly` or `spend_limit_monthly`; null when it is not stopped

  • low_balance_thresholdstringrequired

    Integer nano-USD as a decimal string

    pattern ^-?[0-9]+$

  • min_launch_balancestringrequired

    Integer nano-USD as a decimal string

    pattern ^-?[0-9]+$

  • spendobjectrequired

    Spend limits and spend so far

    Show 5 fields of spend
    • hourly_limitstring | nullrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

    • monthly_limitstring | nullrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

    • last_hourstringrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

    • month_to_datestringrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

    • breachedstring | nullrequired

      Which spend limit has been reached (running compute is stopped and new work refused until spend falls below it or it is raised); null when neither

      One ofhourlymonthly

  • auto_rechargeobjectrequired

    Automatic top-ups: when available credit falls below `threshold`, the saved card is charged to bring it back to `target`, at most `monthly_cap` per calendar month

    Show 7 fields of auto_recharge
    • enabledbooleanrequired

      Whether the saved card is charged automatically when credit runs low

    • thresholdstring | nullrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

    • targetstring | nullrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

    • monthly_capstring | nullrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

    • payment_method_idstring | nullrequired

      ID of the payment method

    • disabled_reasonstring | nullrequired

      Why the platform turned auto-recharge off (for example a failed charge or a removed card); null when you turned it off or it is on

    • charged_this_monthstringrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

  • top_upobjectrequired

    Smallest and largest top-up allowed for this organization

    Show 2 fields of top_up
    • minstringrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

    • maxstringrequired

      Integer nano-USD as a decimal string

      pattern ^-?[0-9]+$

  • card_verifiedbooleanrequired

    A card payment has succeeded; until then GPU compute cannot run on promotional credit alone

  • new_org_limitsbooleanrequired

    Small quotas apply until a payment has aged

  • quotasobjectrequired

    Limits in force for this organization, by quota name (for example `sandboxes` or `inference_rpm`)

  • payment_driverstring | null

    How top-ups are taken here: `stripe` (hosted Checkout), `development` (test credit granted at once, no money taken), or null when payments are disabled. Present on the customer billing routes.

    One ofstripedevelopment

Example
{
  "object": "billing_account",
  "org_id": "org_01jc5zq4m8k3v6x9t2w7r0b1e4",
  "status": "active",
  "suspended_reason": "string",
  "paid": "1500000000",
  "promo": "1500000000",
  "held": "1500000000",
  "available": "1500000000",
  "out_of_credit": true,
  "compute_stops_at": "2026-01-01T00:00:00.000Z",
  "compute_stopped_at": "2026-01-01T00:00:00.000Z",
  "compute_stop_reason": "string",
  "low_balance_threshold": "1500000000",
  "min_launch_balance": "1500000000",
  "spend": {
    "hourly_limit": "1500000000",
    "monthly_limit": "1500000000",
    "last_hour": "1500000000",
    "month_to_date": "1500000000",
    "breached": "hourly"
  },
  "auto_recharge": {
    "enabled": true,
    "threshold": "1500000000",
    "target": "1500000000",
    "monthly_cap": "1500000000",
    "payment_method_id": "string",
    "disabled_reason": "string",
    "charged_this_month": "1500000000"
  },
  "top_up": {
    "min": "1500000000",
    "max": "1500000000"
  },
  "card_verified": true,
  "new_org_limits": true,
  "quotas": {},
  "payment_driver": "stripe"
}

Used by