Search resend by seller reference number
Enterprise-only. Returns the resends whose resend shipment carries one of the supplied sellerReferenceNumber values.
sellerReferenceNumber you supplied when calling Create resend by SKU, and returns the resendId of each match. Resend actions still take Return Helper’s resendId — this endpoint is how you retrieve it, so you do not have to store it on your side. Values are matched exactly — no partial or wildcard search.
Cancel a resend you only know by your own reference
- Call this endpoint with your
sellerReferenceNumber. - Read
resendIdandresendStatusCodefrom the results and pick the resend you want. - Call Cancel resend order with that
resendId.
sellerReferenceNumber is not unique. Cancelling and re-creating a resend legitimately produces more than one resend carrying the same value, so a search can return several results. Always check resendStatusCode before choosing which resendId to act on.Which resends are searchable
Resends created with Create resend order carry nosellerReferenceNumber and never appear here — look those up by resendId with Get resend order details.
Matching status updates to your own records
The resend status update webhook (category: resend / action: updateResendStatus) carries sellerReferenceNumber in resendShipmentList[]. Subscribe to it and reconcile each event against your own order record as it arrives — that is the intended way to track a resend’s lifecycle. Use this search endpoint for on-demand lookups, such as immediately before cancelling.
Pagination
This endpoint uses cursor-based pagination. Each response carriesnextCursor and previousCursor:
nextCursoris the token for the next page, ornullwhen you have reached the last page.previousCursoris the token for the previous page, ornullon the first page.
nextCursor value back as the cursor query parameter with isForward=true. Keep the same pageSize and filters across every request in a pagination sequence.
Related
- Create resend by SKU — where
sellerReferenceNumberis supplied. - Cancel resend order — cancel using the
resendIdyou found here. - Webhooks — resend status update events, delivered with
sellerReferenceNumber.
Authorizations
Your API key
Your API token — keep this private
Query Parameters
Comma-separated list of seller reference numbers to match (e.g. ORDER-0001,ORDER-0002). Required, at least one value. Each value must be non-empty, single-line, and 1–50 characters. The number of entries must not exceed 100.
Number of resends to return per page. Required. Minimum 1, maximum 1000.
1 <= x <= 1000Filter to a single resend status. Not a list. Omit to return resends in every status. Optional.
pending, canceled, in-progress, completed, failed, queued, label-success Opaque, versioned cursor token. Pass the nextCursor (or previousCursor) from a previous response to fetch the adjacent page. Omit to fetch the first page. Optional.
Pagination direction. Set true to page forward through results using the returned nextCursor. Defaults to false when omitted. Optional.
Response
Success
Cursor-paginated list of resends matching the supplied seller reference numbers. The business payload (nextCursor, previousCursor, data) is returned as top-level fields alongside the standard correlationId and meta envelope.