What does the response from the Storefront GraphQL API look like when you have hit a rate limit?

Retired Boards Appdev Custom Storefronts

Topic summary

Behavior when exceeding Shopify Storefront GraphQL API rate limits.

Latest clarification: The API returns an HTTP 429 (Too Many Requests) status when the limit is hit, with a “Try Again” message provided in the response headers.

Reference: A link to Shopify’s rate limit documentation was provided (https://shopify.dev/api/usage/rate-limits) for details on thresholds and best practices.

Unanswered detail: The reply does not specify whether the response includes a body; the original question asked if it’s a 429 with no body.

Outcome: Partial resolution—status code and header behavior confirmed; body content remains unclear. Next step is to consult the documentation or test the behavior directly to verify the presence/format of any response body.

Summarized with AI on February 15. AI used: gpt-5.
1

I am looking for a description of what happens when you’ve actually hit the Storefront GraphQL Api’s rate limit. Does it just send back a 429 and no body?

2

Hi @emiller . You should see a 429 error along with a Try Again message in the response header. The documentation on limits can be found here. https://shopify.dev/api/usage/rate-limits.