Skip to main content
GET
Get subscription and usage state

Authorizations

Authorization
string
header
required

API key: Authorization: Bearer sk_test_... or sk_live_....

Headers

Invoice-Version
string

Pin a dated API release (Stripe-style). Omit to use the current version. An unknown value returns 400 request.invalid_version. Echoed back on every response.

Example:

"2026-07-10"

Invoice-Account
string

Connect: act on behalf of one of your connected accounts (its acct_…/org_… id). Omit to act as your own organization. Not honored on /v1/api_keys.

Example:

"org_2P9connectedacct"

Response

Default Response

object
enum<string>
required

Always "billing".

Available options:
billing
plan
enum<string>
required

The subscription plan this organization is on.

Available options:
free,
starter,
growth,
scale
subscription_status
string
required

Provider subscription status: "none" (free), "active", "past_due", "canceled", "unpaid", …

monthly_price_mxn
string | null
required

Monthly base price in MXN (IVA included), e.g. "349.00"; null on the free plan.

included_stamps
integer
required

Live CFDI stamps included per month before overage (free: hard cap).

Required range: -9007199254740991 <= x <= 9007199254740991
overage_price_mxn
string | null
required

Price per extra live stamp in MXN, e.g. "0.60"; null on the free plan (hard cap).

stamps_this_month
integer
required

Live stamps consumed in the current calendar month (UTC).

Required range: -9007199254740991 <= x <= 9007199254740991
sat_xmls_this_month
integer
required

Billable XMLs delivered by SAT downloads this month (Mexico City calendar).

Required range: -9007199254740991 <= x <= 9007199254740991
sat_active_rfcs_this_month
integer
required

RFCs with at least one billable SAT download this month (Mexico City calendar).

Required range: -9007199254740991 <= x <= 9007199254740991
sat_xml_price_mxn
string
required

Price per XML delivered by a SAT download, in MXN (IVA included), e.g. "0.696".

sat_active_rfc_price_mxn
string
required

Price of the first active RFC per month, in MXN (IVA included), e.g. "114.84". See sat_active_rfc_tiers for the full schedule.

sat_active_rfc_tiers
object[]
required

Active-RFC price schedule for this organization's plan. Graduated: each RFC pays its own step's rate. Starter has one flat step; Growth and Scale get cheaper steps.

has_billing_account
boolean
required

True once a billing customer exists (after the first checkout).