> ## 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.

# Get resend shipping fees by destination

Returns the **resend** outbound service types available for one or more return inventory items shipping to a given destination (country + postal code), each **with an estimated fee**. Use it to preview resend pricing before calling [Create resend order](/api-reference/resend/create-resend-order).

<Note>
  This endpoint prices **resend** (outbound) shipments only. For **return** (inbound) fee previews, use [Get shipping fees from origin location](/api-reference/shipment/get-shipping-fees-from-origin-location) instead.
</Note>

## Required parameters

* **`returnInventoryIdList`** — required. A comma-separated list of return inventory IDs (e.g. `10023,10024`) to be resent together. **All IDs must belong to the same warehouse**, and each must exist; otherwise the request fails validation.
* **`toCountryCode`** — required, **lowercase ISO3** (e.g. `usa`, `gbr`). See [Get all countries](/api-reference/country/get-all-countries) for valid values.
* **`toPostalCode`** — required, non-empty.
* **`limit`** — optional. Caps the number of service-type options returned; omit it to receive all options available for the destination.

## Response notes

Each entry describes one available resend service type and its fee:

* `serviceTypeCode` / `serviceTypeName` — the service identifier and its display name.
* `isEnableAutoCreateLabel` — whether the label is generated automatically when the resend order is created with this service.
* `postalCodePair` — the `from` / `to` postal-code zone pair used to derive the rate.
* `currencyCode` and `fee` — the estimated charge.
* `chargeableWeight` — the weight the carrier bills on, which may exceed the parcel's actual weight due to dimensional-weight rounding.

An empty list means no resend service is available for that inventory set and destination. Fees are estimates; the definitive charge is applied when the resend order is created.

## Related

* [Create resend order](/api-reference/resend/create-resend-order) — uses the chosen `serviceTypeCode`.
* [Get resend order details](/api-reference/resend/get-resend-order-details) — inspect a resend order after creation.
* [Get shipping fees from origin location](/api-reference/shipment/get-shipping-fees-from-origin-location) — the return (inbound) fee-preview counterpart.


## OpenAPI

````yaml get /api/Resend/getShippingFeeListByToShippingOption
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/getShippingFeeListByToShippingOption:
    get:
      tags:
        - Resend
      summary: Get resend shipping fees by destination
      operationId: ReturnUserApi_GetShippingFeeListByToShippingOption
      parameters:
        - name: returnInventoryIdList
          in: query
          required: true
          schema:
            type: string
          description: >-
            Comma-separated list of return inventory IDs to price the resend
            for. All IDs must belong to the same warehouse.
        - name: toCountryCode
          in: query
          required: true
          schema:
            type: string
          description: ISO3 destination country code
        - name: toPostalCode
          in: query
          required: true
          schema:
            type: string
          description: Destination postal code
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: 0
          description: Maximum number of service-type fee options to return
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/GeneralList_ShipmentShippingFeeDetailReply
        '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:
    GeneralList_ShipmentShippingFeeDetailReply:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/ShipmentShippingFeeDetailReply'
          description: List of available resend service types with their shipping fee
    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'
    ShipmentShippingFeeDetailReply:
      type: object
      properties:
        serviceTypeCode:
          type:
            - string
            - 'null'
        serviceTypeName:
          type:
            - string
            - 'null'
        isEnableAutoCreateLabel:
          type: boolean
        postalCodePair:
          type: object
          description: Postal-code zone pair used to derive the rate
          properties:
            from:
              type:
                - string
                - 'null'
              description: Origin postal-code zone
            to:
              type:
                - string
                - 'null'
              description: Destination postal-code zone
        currencyCode:
          type:
            - string
            - 'null'
        fee:
          type: number
          format: decimal
        chargeableWeight:
          type: number
          format: decimal
    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.
  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

````