Join us for an upcoming Shopify Partner webinar on February 27, 2024. Discover the latest Checkout Extensibility features, and deep dive on improvements to Shopify Functions and Web Pixels. Register now for either the 10am EST or 2pm EST sessions.

Checkout API Error Messages are Vague

Shopify Partner
21 1 6



We are a sales channel using the checkout API. Recently we had a scenario, where we attempted to create a checkout with an OOS item and received a 422 HTTP response. The error message in the response just stated that there was invalid input, which wasn't terribly helpful in understanding where we erred. It would be awesome if we could get similar message to other APIs, which could indicate the field that is incorrect. 


One way I've thought of to mitigate this is to add each line item to the cart one at a time, and handle errors on our side appropriately. However, this does increase the number of requests to the Shopify backend. Please let me know if there's another preferred way to handle OOS items being added to a checkout. 



Replies 2 (2)

Shopify Staff (Retired)
624 104 186

Hey @jbgrunewald ,


For Sales Channels, perhaps it might be worth looking into using the GraphQL Storefront API instead for creating the checkout experience? Since it uses GraphQL, the error messaging is different. Also with the Storefront API the rate limiting in on a per customer IP basis, so you do not have to worry about sending too many requests for adding one line item at a time.


To learn more visit the Shopify Help Center or the Community Blog.

Shopify Partner
21 1 6

Thanks, I'll need to take a look at the store front API more closely to make an informed decision. At first glance there may be some blockers to our current setup. We would be grateful if you could pass along the feedback for the checkout API. In the meantime, I'll take a closer look and see if the storefront API might work for our use case.