QUICKSTART
API Quick Start
Authentication
SignString
Rate Limit
Body Envelope
Request Errors
CHANGELOG
Changelog
Migration
Migrate from 2025-01
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
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
Model
Primitive
Address
Money
Envelope
Meta
Error
Resource
Return
Return item
Item tag
Webhook
Webhook Overview
Webhook Specifications
Webhook Outgoing IPs
Webhook Signature
Support
Contact Support

Record dropped-off return items

post
/returns/rma/{rma_number}/dropoffs/{dropoff_id}/drops

This endpoint applies to dropoffs powered by AfterShip QR Code: When a shopper drops some return items at the location, the merchant's sytem should scan the QR code, extract the rma_number, dropoff_id, and then call this endpoint to mark the items as dropped.

For 3rd party droppoff service providers to call this endpoint on behalf of merchant: please note that you need to extract the organization_id and use an API Key of that specific organization.

Request

Path Parameters

dropoff_id
string
required

This dropoff ID can be found in the QR code generated at AfterShip Returns.

rma_number
string
required

Body

items
array[dropoff_drop_item.v2]
external_order_item_id
string
quantity
integer
>= 1
dropped_at
string<date-time>
Auth
:
Parameters
:
:
Body
preparing...