> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.returnhelper.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seller Reference Number で Resend を検索

> Enterprise-only. Returns the resends whose resend shipment carries one of the supplied `sellerReferenceNumber` values.

<Warning>
  このページはAIによって自動翻訳されています。API技術仕様は英語が正式です。不明点がある場合は[英語版](/api-reference/resend/search-resend-by-seller-reference-number)を参照してください。
</Warning>

<Note>
  これは **Enterprise 専用** 機能で、Return Helper Enterprise のお客様のみ利用できます。有効化されていないアカウントからのリクエストは拒否されます。詳しくは [enterprise-solution@returnhelper.com](mailto:enterprise-solution@returnhelper.com) までお問い合わせください。
</Note>

[Create resend by SKU](/ja/api-reference/resend/create-resend-by-sku) を呼び出したときに指定した `sellerReferenceNumber` で resend を検索し、一致した各 resend の `resendId` を返します。resend に対する操作には引き続き Return Helper の `resendId` が必要です。本エンドポイントはその `resendId` を取得する手段であり、お客様側で `resendId` を保存しておく必要はありません。値は**完全一致**で照合され、部分一致やワイルドカード検索はできません。

<h2 id="cancel-a-resend-you-only-know-by-your-own-reference">
  自社の参照番号しか分からない場合に resend をキャンセルする
</h2>

1. お客様の `sellerReferenceNumber` を指定して本エンドポイントを呼び出します。
2. 結果から `resendId` と `resendStatusCode` を読み取り、対象の resend を選びます。
3. その `resendId` で [Cancel resend order](/ja/api-reference/resend/cancel-resend-order) を呼び出します。

<Note>
  `sellerReferenceNumber` は**一意ではありません**。キャンセルして再作成すると、同じ値を持つ resend が複数生じることが正常にあり得るため、検索が複数件を返す場合があります。どの `resendId` を操作するか決める前に、必ず `resendStatusCode` を確認してください。
</Note>

<h2 id="which-resends-are-searchable">
  検索できる resend
</h2>

[Create resend order](/ja/api-reference/resend/create-resend-order) で作成した resend は `sellerReferenceNumber` を持たないため、本エンドポイントの結果には現れません。それらは `resendId` を使って [Get resend order details](/ja/api-reference/resend/get-resend-order-details) で参照してください。

<h2 id="matching-status-updates-to-your-own-records">
  ステータス更新を自社のレコードと突き合わせる
</h2>

[再送ステータス更新 webhook](/ja/webhooks#resend-status-update)（`category: resend` / `action: updateResendStatus`）は `resendShipmentList[]` に `sellerReferenceNumber` を含みます。このイベントを購読し、届いた時点でお客様自身の注文レコードと突き合わせてください。これが resend のライフサイクルを追跡する推奨方法です。本検索エンドポイントは、キャンセル直前など、必要なときに参照する用途に使用します。

<h2 id="pagination">
  ページネーション
</h2>

このエンドポイントは**カーソルベースのページネーション**を使用します。各レスポンスには `nextCursor` と `previousCursor` が含まれます。

* `nextCursor` は次のページのカーソルです。最後のページに達した場合は `null` になります。
* `previousCursor` は前のページのカーソルです。最初のページでは `null` になります。

前方向にページ送りするには、`nextCursor` の値を `cursor` クエリパラメータとして渡し、`isForward=true` を指定します。1 つのページネーションシーケンス内では、同じ `pageSize` とフィルタを維持してください。

<h2 id="related">
  関連
</h2>

* [SKU で Resend を作成](/ja/api-reference/resend/create-resend-by-sku) — `sellerReferenceNumber` はここで指定します。
* [Resend Order をキャンセル](/ja/api-reference/resend/cancel-resend-order) — 本エンドポイントで見つけた `resendId` を使ってキャンセルします。
* [Webhooks](/ja/webhooks) — 再送ステータス更新イベント。`sellerReferenceNumber` を伴って配信されます。


## OpenAPI

````yaml get /api/Resend/searchResendBySellerReferenceNumber
openapi: 3.1.0
info:
  title: Return Helper API
  description: API documentation for Return Helper — covering User and Public endpoints.
  version: 1.0.0
servers:
  - url: https://api.returnshelper.com/uat/user
    description: Sandbox — User API
  - url: https://api.returnshelper.com/uat/public
    description: Sandbox — Public API
  - url: https://api.returnhelpercentre.com/v1/user
    description: Production — User API
  - url: https://api.returnhelpercentre.com/v1/public
    description: Production — Public API
  - url: https://api.returnhelperchina.com/user
    description: Production — User API (China)
security:
  - ApiKey: []
    ApiToken: []
paths:
  /api/Resend/searchResendBySellerReferenceNumber:
    get:
      tags:
        - Resend
      summary: Search resend by seller reference number
      description: >-
        Enterprise-only. Returns the resends whose resend shipment carries one
        of the supplied `sellerReferenceNumber` values.
      operationId: ReturnUserApi_SearchResendBySellerReferenceNumber
      parameters:
        - name: sellerReferenceNumberList
          in: query
          required: true
          schema:
            type: string
          description: >-
            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.
        - name: pageSize
          in: query
          required: true
          schema:
            type: integer
            minimum: 1
            maximum: 1000
          description: >-
            Number of resends to return per page. Required. Minimum 1, maximum
            1000.
        - name: resendStatusCode
          in: query
          required: false
          schema:
            type: string
            enum:
              - pending
              - canceled
              - in-progress
              - completed
              - failed
              - queued
              - label-success
          description: >-
            Filter to a single resend status. Not a list. Omit to return resends
            in every status. Optional.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            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.
        - name: isForward
          in: query
          required: false
          schema:
            type: boolean
          description: >-
            Pagination direction. Set `true` to page forward through results
            using the returned `nextCursor`. Defaults to `false` when omitted.
            Optional.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/SearchResendBySellerReferenceNumberResponse
        '401':
          description: >-
            Authentication failed. Returned when the `x-rr-apikey` or
            `x-rr-apitoken` header is missing or invalid. The body uses the
            standard `ApiResponse` envelope with `meta.error.message` describing
            the auth failure.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResponse'
      security:
        - ApiKey: []
          ApiToken: []
      servers:
        - url: https://api.returnshelper.com/uat/user
          description: Sandbox — User API
components:
  schemas:
    SearchResendBySellerReferenceNumberResponse:
      type: object
      description: >-
        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.
      properties:
        nextCursor:
          type:
            - string
            - 'null'
          description: >-
            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:
          type:
            - string
            - 'null'
          description: >-
            Cursor token for the previous page, or `null` when there is no
            previous page.
        data:
          type: array
          items:
            $ref: '#/components/schemas/SearchResendBySellerReferenceNumberReply'
          description: Resends for the current page
    ApiResponse:
      type: object
      description: >-
        Universal response envelope. Successful responses include the business
        payload as additional top-level fields alongside `correlationId` and
        `meta`. Failed responses (auth errors, validation errors) only populate
        `correlationId` and `meta`, with `meta.errorCode` and `meta.error`
        describing the failure.
      properties:
        correlationId:
          type:
            - string
            - 'null'
          description: >-
            Unique correlation ID for tracing the request through Return Helper
            systems.
        meta:
          $ref: '#/components/schemas/ApiResponseMeta'
    SearchResendBySellerReferenceNumberReply:
      type: object
      properties:
        resendId:
          type: integer
          format: int64
          description: Resend identifier. Pass this to Cancel resend order.
        resendStatusCode:
          type:
            - string
            - 'null'
          description: >-
            Current resend status: `pending`, `canceled`, `in-progress`,
            `completed`, `failed`, `queued`, or `label-success`.
        description:
          type:
            - string
            - 'null'
          description: Free-text description set when the resend was created
        remarks:
          type:
            - string
            - 'null'
          description: Merchant remarks/notes set when the resend was created
        resendShipmentList:
          type: array
          items:
            $ref: '#/components/schemas/ResendShipmentPayload'
          description: Resend shipments belonging to this resend
    ApiResponseMeta:
      type: object
      description: >-
        Application-level metadata for every API response. Inspect `status` and
        `errorCode` to detect soft-error responses (validation failures arrive
        as HTTP 200 with `meta.status: 400`).
      properties:
        status:
          type: integer
          description: >-
            Application-level status code. For successful operations this
            mirrors the HTTP status (e.g. 200). For validation failures it
            reports the logical status (e.g. 400) even though the wire HTTP
            status is 200.
        data:
          type: object
          additionalProperties:
            type: string
          description: Reserved free-form metadata key/value pairs. Usually empty.
        errorCode:
          type:
            - string
            - 'null'
          description: >-
            Machine-readable error code (e.g. `VALIDATION_FAILED`). Non-null
            only when the operation failed.
        error:
          type: object
          additionalProperties: true
          description: >-
            Field-level or message-level error detail keyed by request property
            name. Empty object on success.
    ResendShipmentPayload:
      type: object
      properties:
        resendShipmentId:
          type: integer
          format: int64
        resendId:
          type: integer
          format: int64
        warehouseId:
          type: integer
          format: int32
        resendShipmentNumber:
          type:
            - string
            - 'null'
        sellerReferenceNumber:
          type:
            - string
            - 'null'
          description: >-
            The reference you supplied when creating the resend through Create
            resend by SKU. Not unique — cancelling and re-creating a resend
            produces more than one resend carrying the same value. `null` for
            resends created any other way.
        shipmentServiceType:
          type:
            - string
            - 'null'
        shipmentCountryCode:
          type:
            - string
            - 'null'
          description: Lowercase ISO3
        shipmentName:
          type:
            - string
            - 'null'
        shipmentPhone:
          type:
            - string
            - 'null'
        shipmentFax:
          type:
            - string
            - 'null'
        shipmentEmail:
          type:
            - string
            - 'null'
        shipmentStreet1:
          type:
            - string
            - 'null'
        shipmentStreet2:
          type:
            - string
            - 'null'
        shipmentStreet3:
          type:
            - string
            - 'null'
        shipmentState:
          type:
            - string
            - 'null'
        shipmentCity:
          type:
            - string
            - 'null'
        shipmentPostalCode:
          type:
            - string
            - 'null'
        trackingNumber:
          type:
            - string
            - 'null'
        error:
          type:
            - string
            - 'null'
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-rr-apikey
      description: Your API key
    ApiToken:
      type: apiKey
      in: header
      name: x-rr-apitoken
      description: Your API token — keep this private

````