Get plan tiers

data

• notestringrequired

  The pricing rules in prose, generated from the same constants that enforce them — including the sentence about plan volume discounts on monthly order counts, which changes on the day a plan has one, and the quantity breaks on one order's units of a SKU.

• pricing_modelobjectrequired
• pricing_model.volume_discountsbooleanrequired

  Whether ANY published plan prices on order volume. False today.

• pricing_model.processing_fee_pctnumberrequireddeprecated

  Deprecated 2026-09-26: the single fee it described is now two lines. Holds platform_fee_pct; read that and the card fields instead.

• pricing_model.platform_fee_pctnumber

  The platform fee this account's next order pays, as a percentage of items plus shipping. 0: there is no platform fee on any order, on any plan, since 2026-10-17.

• pricing_model.card_fee_pctnumber

  Card processing's percentage, passed through at cost on everything else the order is charged.

• pricing_model.card_fee_fixed_centsinteger

  Card processing's fixed part per charge, in cents.

• pricing_model.catalog_discount_pctnumberrequired

  The discount that will actually apply to this account's next order.

• tiersobject[]required

  Every plan, offered ones first, then retired ones.

• tiers[].tierintegerrequired

  1-based position in this list, offered plans first. An ordering, not a ranking.

• tiers[].planstringrequired

  The plan id an upgrade would name (starter, …).

• tiers[].namestringrequired

  Display label (Free, …).

• tiers[].offeredbooleanrequired

  Whether this plan can be bought on this portal today. False means it is not sold here — accounts already on it keep it, nobody new can join it.

• tiers[].monthly_price_centsintegerrequired
• tiers[].catalog_discount_pctnumberrequired

  % off the products our own plant makes (stickers, labels, decals, magnets, posters) this plan GRANTS, never below a unit's cost floor. No plan sold on this portal grants one. What the account may take today is current.entitled_catalog_discount_pct.

• tiers[].platform_fee_pctnumber

  The platform fee this plan pays, as a percentage of items plus shipping. 0 on every plan: there is no platform fee on any order since 2026-10-17. Card processing is separate and passed through at cost.

• tiers[].discount_percentnumberrequired

  Deprecated alias of catalog_discount_pct, kept because it is the field this endpoint has always published. It used to mean a volume discount and was hardcoded to 0; it now carries the plan discount, the only discount a plan grants. The quantity breaks on our own plant's goods are per order, not per plan, and the note states them.

• tiers[].requests_per_minuteintegerrequired
• tiers[].requests_per_dayintegerrequired
• tiers[].recommended_monthly_ordersstringrequired

  The order volume this plan is SUGGESTED for. Nothing is enforced on it — exceeding it costs nothing and changes nothing.

• tiers[].min_ordersinteger | nullrequired

  The volume this plan's discount ladder starts at. Null on every plan today, because no plan carries a ladder — not zero, which would read as one starting at the first order.

• tiers[].max_ordersinteger | nullrequired

  The top of the ladder. Null when there is none, and also when its top rung is open-ended (which it always is).

• tiers[].bandsobject[]required

  The plan's volume ladder, lowest rung first. Empty means one flat discount at every volume — which is every plan today.

• tiers[].bands[].min_ordersintegerrequired

  Inclusive lower bound, in billed orders over the trailing window.

• tiers[].bands[].max_ordersinteger | nullrequired

  Inclusive upper bound; null on the open-ended top rung.

• tiers[].bands[].catalog_discount_pctnumberrequired

  % off the products our own plant makes at that volume.

• tiers[].labelstringrequired

  Price and the single most distinguishing benefit, prebuilt for display.

• tiers[].featuresstring[]required
• currentobjectrequired

  The plan this key's account is on.

• current.tierintegerrequired
• current.planstringrequired
• current.namestringrequired
• current.offeredbooleanrequired
• current.catalog_discount_pctnumberrequired

  What the plan grants.

• current.discount_percentnumberrequired

  Deprecated alias of catalog_discount_pct.

• current.entitled_catalog_discount_pctnumberrequired

  What the account may take TODAY, on our own plant's goods. Lower than catalog_discount_pct while a subscription is past_due, canceled or unpaid — budget against this one, not the plan's headline.

• current.monthly_ordersanyrequired

  Always null. This endpoint does not count your orders, and nothing prices on volume. Zero would read as "you have shipped nothing" to a merchant who has shipped thousands.

• next_tierobject | nullrequired

  The next plan up, or null when there is none to move to.

• next_tier.tierintegerrequired
• next_tier.planstringrequired
• next_tier.namestringrequired
• next_tier.monthly_price_centsintegerrequired
• next_tier.catalog_discount_pctnumberrequired
• next_tier.discount_percentnumberrequired

  Deprecated alias of catalog_discount_pct.

• next_tier.orders_neededanyrequired

  Always null. No plan is reached by placing orders, so there is no count that would get you there. Zero would read as "you already qualify".

meta

• pageinteger
• totalinteger
• limitinteger

  The page size actually applied, which is not necessarily the one asked for — the operation's own ceiling wins.

• pagesinteger

  total over limit, rounded up.

• next_cursorstring | null

  On a cursor-paged operation: send this back as cursor for the next page. Null on the last page. Absent on operations that do not page by cursor.

• has_moreboolean

  On a list operation whose meta is ListMeta: whether another page follows this one.