Skip to main content
GET
/
api
/
Shipment
/
getShippingFeeListByFromShippingOption
Get shipping fees from origin location
curl --request GET \
  --url https://api.returnshelper.com/uat/user/api/Shipment/getShippingFeeListByFromShippingOption \
  --header 'x-rr-apikey: <api-key>' \
  --header 'x-rr-apitoken: <api-key>'
{
  "data": {
    "shippingFeeDetailList": [
      {}
    ]
  }
}
Returns the list of return service types available for a given origin (country + postal code) and parcel size/weight, with an estimated fee for each. Use this as the fee-preview companion to the other /api/ServiceType/* lookups before committing to Create return shipment. There is no fee guarantee at preview time, but the same combination will normally produce the same fee on shipment creation. This is the return catalogue with fees attached. For resend outbound services, this endpoint does not apply — start from Get available shipment service types for warehouse. Resend fees are determined at order-creation time, not previewable through this endpoint.

​
When to call

  • To pick the cheapest return price for a parcel of known dimensions and weight.
  • During integration testing, to verify which return services your account is wired up for in a given country.

​
Required parameters

  • fromCountryCode — required, lowercase ISO3 (e.g. usa, gbr). See Get all from countries for valid values.
  • fromPostalCode — required, non-empty.
  • weight, dimension1, dimension2, dimension3 — all required and must all be > 0.
  • limit — optional, capped at 50. Defaults to no limit when omitted (the response is bounded by available services).

​
Response notes

  • Each entry includes serviceTypeCode, serviceType (display name), warehouseId (the warehouse receiving the return items), currencyCode, and fee.
  • The list is filtered to return services your account is authorised for at that origin. An empty response means no service fits the requested size/weight at that origin.
  • chargeableWeight is what the carrier will bill on, which may exceed actual weight due to dimensional weight rounding.

Authorizations

​
x-rr-apikey
string
header
required

Your API key

​
x-rr-apitoken
string
header
required

Your API token — keep this private

Query Parameters

​
fromCountryCode
string
required

ISO3 origin country code

​
fromPostalCode
string
required

Origin postal code

​
weight
number<decimal>
required

Parcel weight

​
dimension1
number<decimal>
required

Length (longest dimension)

​
dimension2
number<decimal>
required

Width (second longest dimension)

​
dimension3
number<decimal>
required

Height (shortest dimension)

​
limit
integer<int32>

Maximum number of results

Required range: 0 <= x <= 50

Response

Success

​
data
object

Shipping fee summary