---
title: Subscription billing attempts throttling - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/subscription-billing-attempts-throttling'
  md: 'https://shopify.dev/changelog/subscription-billing-attempts-throttling.md'
metadata:
  effectiveApiVersion: 2026-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-10-23T09:56:37-04:00'
  postedAt: '2026-01-01T12:00:00-05:00'
  updatedAt: '2025-10-27T10:06:58-04:00'
  effectiveAt: '2026-01-01T12:00:00-05:00'
---

January 1, 2026

Tags:

* Admin GraphQL API
* 2026-01

# Subscription billing attempts throttling

Beginning in API version 2026-01, billing attempts will be throttled based on internal trust metrics to prevent abuse. If an attempt is throttled, it will be visible in the new `throttled` error code on the [`BillingAttemptUserErrorCode`](https://shopify.dev/docs/api/admin-graphql/latest/enums/BillingAttemptUserErrorCode) enum.