Returns, Fulfillments and more Product info for the customer-accounts API

Shopify Apps

Topic summary

A developer requests expanded data in the Shopify customer-accounts API to match the Admin Orders object, specifically for building Order Status page experiences. They want access to everything visible on the Order Status page without falling back to the Admin API.

Key missing fields cited:

  • Returns (return/RMA details)
  • Fulfillments (shipping/fulfillment statuses)
  • Product node and product metafields (custom product metadata)

Current workaround: Query the Admin API to fetch these fields. However, this is described as poorly suited for customer-facing contexts due to scalability concerns and difficulty caching the data.

Primary ask: Clarification on if/when “parity” with the Admin Orders object will be achieved for the customer-accounts API, enabling direct retrieval of returns, fulfillments, and product information.

Outcome/status: No decisions or timelines are provided in the conversation. The request remains open, seeking an official update or roadmap details.

Summarized with AI on December 13. AI used: gpt-5.
1

The customer-accounts API currently doesn’t have some key fields that make developing apps for the OrderStatus page awkward. It’d be great to understand if/when there will be “parity” with the Orders object in admin API. Effectively, I was hoping we’d have access to everything currently visible on the OrderStatus page, such as:

  • returns

  • fulfillments

  • a Product node and product metafields

To fetch these fields for an order, we need to use the admin API, which doesn’t scale well for customer-facing data and it can be hard to cache it.