Orders: returnlineitem

Returns a line item. Try it now.

Please note that marking an item as returned does not necessarily create a refund. If you wish to provide a full or partial refund, please use the refund method.


HTTP request

POST https://www.googleapis.com/content/v2/merchantId/orders/orderId/returnLineItem


Parameter name Value Description
Path parameters
merchantId unsigned long The ID of the account that manages the order. This cannot be a multi-client account.
orderId string The ID of the order.


This request requires authorization with the following scope:


For more information, see the authentication and authorization page.

Request body

In the request body, supply data with the following structure:

  "operationId": string,
  "lineItemId": string,
  "productId": string,
  "quantity": unsigned integer,
  "reason": string,
  "reasonText": string
Property name Value Description Notes
operationId string The ID of the operation. Unique across all operations for a given order.
lineItemId string The ID of the line item to return. Either lineItemId or productId is required.
quantity unsigned integer The quantity to return.
reason string The reason for the return.

Acceptable values are:
  • "customerDiscretionaryReturn"
  • "customerInitiatedMerchantCancel"
  • "deliveredTooLate"
  • "expiredItem"
  • "invalidCoupon"
  • "malformedShippingAddress"
  • "other"
  • "productArrivedDamaged"
  • "productNotAsDescribed"
  • "qualityNotAsExpected"
  • "undeliverableShippingAddress"
  • "unsupportedPoBoxAddress"
  • "wrongProductShipped"
reasonText string The explanation of the reason.
productId string The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.


If successful, this method returns a response body with the following structure:

  "kind": "content#ordersReturnLineItemResponse",
  "executionStatus": string
Property name Value Description Notes
kind string Identifies what kind of resource this is. Value: the fixed string "content#ordersReturnLineItemResponse".
executionStatus string The status of the execution.

Acceptable values are:
  • "duplicate"
  • "executed"

Send feedback about...

Content API for Shopping