Skip to main content
GET
Search resend by seller reference number
This is an Enterprise-only feature, enabled only for Return Helper Enterprise customers. Requests from accounts that are not enabled are denied. To learn more, contact enterprise-solution@returnhelper.com.
Finds resends by the 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

  1. Call this endpoint with your sellerReferenceNumber.
  2. Read resendId and resendStatusCode from the results and pick the resend you want.
  3. 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 no sellerReferenceNumber 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 carries nextCursor and previousCursor:
  • nextCursor is the token for the next page, or null when you have reached the last page.
  • previousCursor is the token for the previous page, or null on the first page.
To page forward, send the nextCursor value back as the cursor query parameter with isForward=true. Keep the same pageSize and filters across every request in a pagination sequence.

Authorizations

x-rr-apikey
string
header
required

Your API key

x-rr-apitoken
string
header
required

Your API token — keep this private

Query Parameters

sellerReferenceNumberList
string
required

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.

pageSize
integer
required

Number of resends to return per page. Required. Minimum 1, maximum 1000.

Required range: 1 <= x <= 1000
resendStatusCode
enum<string>

Filter to a single resend status. Not a list. Omit to return resends in every status. Optional.

Available options:
pending,
canceled,
in-progress,
completed,
failed,
queued,
label-success
cursor
string

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.

isForward
boolean

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.

nextCursor
string | null

Cursor token for the next page, or null when there is no next page. Pass it back as cursor with isForward=true to page forward.

previousCursor
string | null

Cursor token for the previous page, or null when there is no previous page.

data
object[]

Resends for the current page