QUICKSTART
API Quick Start
Authentication
SignString
Versioning
Rate Limit
Body Envelope
Request Errors
CHANGELOG
Changelog
Migration
Migrate from 2025-04
Reference
API Overview
Returns
Get return detail by ID
get
Get return detail by RMA number
get
Get returns
get
Create Return
post
Approve Return By RMA number
post
Approve Return By Return ID
post
Resolve Return By RMA number
post
Resolve Return By Return ID
post
Reject Return By RMA number
post
Reject Return By Return ID
post
Receive items by RMA number
post
Receive items by Return ID
post
Attach shipments by RMA number
post
Attach shipments by Return ID
post
Remove return items by Return ID
post
Remove return items by RMA number
post
Return Dropoffs
Record dropped-off return items
post
Return items
Update return items by Return ID
patch
Update return items By RMA number
patch
Item tags
Get item tags
get
Returns Page
Create Returns Page Deep Link
post
Model
Primitive
Address
Money
Envelope
Meta
Error
Resource
Return
Return item
Item tag
enum
Platforms
Webhook
Webhook Overview
Webhook Specifications
Webhook Outgoing IPs
Webhook Signature
Support
Contact Support

Remove return items by Return ID

post
/returns/{return_id}/remove-items

When a shopper changes their mind and no longer wants to return all items, you can use this API to remove specific items from the return. This functionality is the same as the "Remove Return Items from an Existing RMA" feature in the Admin Portal. For more information, please refer to: https://support.aftership.com/en/returns/article/remove-return-items-from-an-existing-rma-133vwu0

Request

Path Parameters

return_id
string
required

Body

items
array[object]
required
external_id
string
required
quantity
integer
required
>= 1
edit_reason
string
required
<= 200 characters
notify_customer
boolean
required
Auth
:
Parameters
:
Body
preparing...