listReturnsget https://sellingpartnerapi-na.amazon.com/externalFulfillment/2024-09-11/returnsRetrieve a list of return items. You can filter results by location, RMA ID, status, or time.Query ParamsreturnLocationIdstringThe SmartConnect location ID of the location from which you want to retrieve return items.rmaIdstringThe RMA ID of the return items you want to list.statusstringenumThe status of return items you want to list. You can retrieve all new return items with the CREATED status.CREATEDCARRIER_NOTIFIED_TO_PICK_UP_FROM_CUSTOMERCARRIER_OUT_FOR_PICK_UP_FROM_CUSTOMERCUSTOMER_CANCELLED_PICK_UPCUSTOMER_RESCHEDULED_PICK_UPPICKED_FROM_CUSTOMERIN_TRANSITOUT_FOR_DELIVERYDELIVEREDREPLANNEDCUSTOMER_DROPPED_OFFPARTIALLY_PROCESSEDPROCESSEDREJECTEDCANCELLEDShow 15 enum valuesreverseTrackingIdstringThe reverse tracking ID of the return items you want to list.createdSincedate-timeReturn items created after the specified date are included in the response. In ISO 8601 date-time format.createdUntildate-timeReturn items created before the specified date are included in the response. In ISO 8601 date-time format.lastUpdatedSincedate-timeReturn items updated after the specified date are included in the response. In ISO 8601 date-time format. If you supply this parameter, you must also supply returnLocationId and status.lastUpdatedUntildate-timeReturn items whose most recent update is before the specified date are included in the response. In ISO 8601 date-time format. If you supply this parameter, you must also supply returnLocationId and status.lastUpdatedAfterdate-timeDEPRECATED. Use the createdSince parameter.lastUpdatedBeforedate-timeDEPRECATED. Use the createdUntil parameter.maxResultsint64≤ 100The number of return items you want to include in the response. Default: 10 Maximum: 100nextTokenstringA token that you use to retrieve the next page of results. The response includes nextToken when there are multiple pages of results. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until nextToken is null. Note that this operation can return empty pages.Responses 200Success. The response contains a list of return items. 400Request has missing or invalid parameters and cannot be parsed. 403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. 404The resource specified does not exist. 409The resource specified conflicts with the current state 413The request size exceeded the maximum accepted size. 415The request payload is in an unsupported format. 429The frequency of requests was greater than allowed. 500An unexpected condition occurred that prevented the server from fulfilling the request. 503Temporary overloading or maintenance of the server.Updated 6 months ago
