# Returns now supported in Customer Accounts API — Shopify developer changelog
---
## Returns now supported in Customer Accounts API

Returns are now supported directly through the [Customer Accounts API](https://shopify.dev/docs/api/customer). This includes new fields and a mutation that allow for querying return-related information and self-serve return requests. 

This update allows partners to seamlessly build return apps on new customer accounts without needing extra app authorizations. Partners can query returns, create new return requests, and customize the return experience for customers. Additionally, these APIs provide partners with visibility into an order line item's return eligibility, which incorporates Shopify's [return rules](https://help.shopify.com/en/manual/fulfillment/managing-orders/returns/return-rules) for merchants with this feature enabled. Partners can determine which items can be returned and the expected refund amount, as well as why items are not returnable. 

#### New APIs:
**[orderRequestReturn](https://shopify.dev/docs/api/customer/unstable/mutations/orderRequestReturn):** Mutation that enables the initiation of a return request directly via API. This mutation supports creating a return request on behalf of a customer, allowing the merchant to use the existing return flows within the Admin.

**[returnCalculate](https://shopify.dev/docs/api/customer/unstable/queries/returnCalculate):** Query that calculates the potential refund amount based on customer inputs if a return request is approved.

**[ReturnInformation](https://shopify.dev/docs/api/customer/unstable/objects/OrderReturnInformation):** Object that provides details about which items in an order are eligible or ineligible for a return.

**[ReturnConnection](https://shopify.dev/docs/api/customer/unstable/connections/ReturnConnection):** Connection on Order that lists returns associated with an order which includes information such as the return's status or associated reverse deliveries.

For the full set of APIs shipped, please refer to the documentation on [Shopify.dev](https://shopify.dev/docs/api/customer/unstable/objects/Order).

*Published: December 11, 2024*
Tags: API, New
Link: https://shopify.dev/changelog/returns-now-supported-in-customer-accounts-api

---