Usage

Account billing snapshot (plan, cycle, balance, caps, status)

The billing "wallet/statement" view: current plan, billing cycle, accrued balance + remaining credits this period, spend caps, and payment / access status. This is the billing half of the legacy /v1/usage-stats snapshot — the per-product consumption half is metering and lives on GET /v1/usage.

Usage-based (Metronome) accounts get a populated balance; legacy Stripe accounts get balance: null plus a deprecated legacy.limits block and, when payment-blocked, status.openInvoiceUrl / status.declineReason.

get/v1/billing

Response

Billing snapshot

billingSystem'metronome' | 'stripe' | 'shopify'
shopifyShopDomainstring nullable

myshopify.com domain owning the subscription; present only when billingSystem is shopify.

Changes

Changed in 1 of the 26 revisions of this API.12

  • 15e893e69e8c12See the full diff
    • added the new shopify enum value to the billingSystem response property for the response status 200

      response-property-enum-value-added

    • added the optional property plan/isPaid to the response with the 200 status

      response-optional-property-added

    • added the optional property shopifyShopDomain to the response with the 200 status

      response-optional-property-added