During our integration testing, however, we ran into some questions and inconsistencies related to the Catalog and Order APIs when working with Combo items, and we would appreciate your clarification.
Observations
Using the Search Catalog API, we are able to successfully query items with product_type = COMBO, and the Combo items are returned as expected.
However, when we attempt to retrieve the same Combo item using the Get Catalog Object API, the request fails with the following error:
Catalog object with ID 'EVYPVTL5YM4PY57VCFDUCZKL' not found.
Additionally, when we attempt to calculate pricing for a Combo item using the Calculate Order API, we encounter the following error:
Catalog object with ID 'DEHP4LIKGV2HRJDTBMOXHTZX' and version 'null' not found.
Questions
Based on the above behavior, we would like to better understand:
Why does the Square Catalog API documentation not yet include details related to Combo items?
Why can Combo items be discovered via Search Catalog, but not retrieved via Get Catalog Object?
Is Combo currently supported by the Calculate Order / Order Creation APIs, and if so, what is the correct way to reference and use Combo items when creating or calculating orders?
Are there any additional requirements (such as specific object types, versions, or parent-child relationships) that must be included when working with Combo items through the API?
Understanding the intended usage and current limitations of Combo items in the Catalog and Order APIs will help us determine the correct integration approach on our side.
Thank you very much for your time and support. We look forward to your guidance.
I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:
If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.
Currently, combo still isn’t supported with the Orders API. What API call are you making that’s returning COMBO? I took a look at your API logs and I don’t see it being returned with SearchCatalogObjects.
Thank you for the clarification. We understand that Combo items are not currently supported by the Orders API, and we appreciate you confirming the current limitation.
Given this, we would like to follow up with a few additional questions to better plan our integration and roadmap:
Orders API support timeline
Is there any estimated timeline or roadmap for when Combo items are expected to be supported in the Orders API? Even a high-level indication (e.g., near-term vs. longer-term) would be very helpful for our planning.
Partner or internal APIs
Are there any partner-level or internal APIs available that already support creating or calculating orders with Combo items? If so, is there a process for becoming eligible to use those APIs?
Recommended workaround or alternative approach
In the absence of Orders API support, is there a recommended way to work with Combo items programmatically?
For example:
Should Combo items be expanded into their component items and submitted as individual line items via the Orders API?
Or are Combo items currently intended to be used only via Square’s Dashboard / POS, rather than through public APIs?
Catalog API behavior
Finally, could you confirm whether Combo objects being returned (or partially discoverable) via Catalog APIs is expected behavior at this stage, or if this functionality is still under development?
Understanding Square’s intended direction for Combo support—both short-term workarounds and longer-term API plans—will help us decide how to best align our implementation with Square’s platform capabilities.
Thank you again for your time and continued support. We look forward to your guidance.
I’m Square Dev AI, here to help answer your question!
