PuppyIP Resource Center
Cross-Border Ecommerce Development 5 min Published 2026-11-18

Shopify Customer Account API 429: How the shared customer limit works

If Shopify’s Customer Account API returns HTTP 429 with THROTTLED, read Retry-After and pause requests for that customer on that store. All apps on the store share the limit of 3,000 requests per minute for that customer. An HTTP 200 response can also carry THROTTLED for the separate GraphQL cost limit.

Shopify Customer Account API HTTP 429 Retry-After

Service eligibility and regional restrictions

PuppyIP serves only compliant overseas businesses and their authorized personnel. Proxy services are not available in mainland China. The service may only be used for lawful business activities outside mainland China. Use of this service within mainland China is prohibited.

Hosting a proxy IP or server overseas does not change these restrictions. The service must not be provided to end users in mainland China through relaying, forwarding, sharing or resale. Before use, read the Terms of Service.

Key Takeaways

  • Shopify counts requests per store and customer. The 3,000-request allowance is shared across apps.
  • HTTP 429 with THROTTLED identifies the request-count limit. Retry-After gives the number of seconds to wait.
  • HTTP 200 with THROTTLED identifies the query-cost limit. Read the GraphQL errors and the cost information in the response.
  • Check polling, repeated reads, overlapping components and retries before letting a batch resume.

What counts toward the 3,000 requests?

Shopify announced the Customer Account API limit on October 7, 2026. It counts requests per minute for each store and customer, combining calls from all apps using the API on that store. The existing GraphQL cost limit still applies.

Suppose two apps on the same store load information for the same customer. Requests from both count toward that customer’s shared limit. Your own logs only show calls from your app. Normal buyer traffic typically stays below the limit, so look for unusual request rates or overlapping retries if you see an alert.

How do you tell the two THROTTLED errors apart?

Check the HTTP status and parse the GraphQL response. HTTP 429 with THROTTLED means the customer reached the request-count limit on that store. The Retry-After response header gives the number of seconds to wait before retrying.

Shopify documents HTTP 200 with a GraphQL THROTTLED error for the query-cost limit. Inspect available values such as requestedQueryCost and actualQueryCost in extensions, then review selected fields, page size and call frequency. Check the error fields before treating the response as successful.

How should your app resume after a 429?

Pause subsequent requests for that store and customer in your app, and wait for the time in Retry-After. If it says 60, for example, wait at least 60 seconds before trying again. Combine duplicate reads, limit competing requests and resume gradually so page components do not all retry together.

Decide how to retry reads and writes separately. For a write, confirm the operation’s outcome and retry conditions first to avoid duplicate submissions. Your queue controls your app’s activity. It still needs to handle 429 responses because other apps use the shared limit.

Where should you look for the trigger?

Group redacted logs by store, customer and time. Keep the operation name, HTTP status, GraphQL error code and any available Retry-After value. Find the first failed batch and check for polling, repeated component loads, pagination loops or concurrent retries around the same time.

If one interaction repeatedly causes the problem, reuse data that the page already retrieved or merge duplicate reads from that action. Observe the resulting request count and error rate in an authorized environment. You do not need to deliberately exhaust the production limit.

Sources

Frequently Asked Questions

Does the Shopify Admin API use this same 3,000-request limit?

This announcement covers the Customer Account API. If the error came from an Admin API call, check Shopify’s documentation for the API you actually called.

Can I calculate the customer’s exact remaining requests from my logs?

Your logs cover your app’s requests, and the limit is shared across apps. If Shopify returns 429, follow its Retry-After value.