PUT /shipping-rates/{id}.json

Bearer auth

Path parameters

id integer(int64) Required

Numeric ID of the instance

Minimum value is 1.

application/json

Body Required

allowList boolean | null Required

This rate will be shown in the allow list or rates that can be selected by vendors in the dropship portal.

Default value is false.
cacheInternalRates boolean | null Required

Cache internal rates

Default value is false.
code string Required

Code
createdAt string(date-time)

Created at
customCarriers string | null

Custom carriers

Values are all, selected, or none.
days integer(int32) | null

Days
defaultWeight integer(int32) | null Required

Default weight

Default value is 0.
dhlExpressServiceLevels array[string] | null Required

Dhl express service levels

Default value is [] (empty).
distanceUnit string | null Required

Distance unit

Values are in or cm. Default value is in.
domesticBandType string | null Required

Domestic band type

Values are weight or price. Default value is price.
enableDiscountedDhlExpressRates boolean | null Required

Enable discounted dhl express rates

Default value is true.
enableDiscountedParcelforceRates boolean | null Required

Enable discounted parcelforce rates

Default value is true.
enableDiscountedUspsRates boolean | null Required

Enable discounted usps rates

Default value is true.
freeShippingOverride boolean | null

Free shipping override
freeShippingOverrideScope string | null Required

Free shipping override scope

Values are value or tags. Default value is value.
freeShippingTags array[string] | null Required

Free shipping tags

Default value is [] (empty).
freeShippingThreshold number | null

Free shipping threshold
handlingFee number | null

Handling fee
id integer(int32)

Id
integrationFilteringEndpoint string | null

Integration filtering endpoint
label string | null

Label
maxPrice integer(int32) | null

Max price
maxPriceUnit string | null Required

Max price unit

Values are fixed or percentage. Default value is fixed.
maximumOrderValue number | null

Maximum order value
name string Required

Name
parcelDepth number | null Required

Parcel depth

Default value is 0.
parcelHeight number | null Required

Parcel height

Default value is 0.
parcelWidth number | null Required

Parcel width

Default value is 0.
parcelforceServiceLevels array[string] | null Required

Parcelforce service levels

Default value is [] (empty).
price number Required

Price

Default value is 0.
priceIncrease number | null Required

Price increase

Default value is 0.
priceType string | null Required

Price type

Values are carrier, fixed, fixed_per_item, weight, banded, banded_price, product_type, or zones. Default value is fixed.
provider string | null

Provider
providerCode string | null

Provider code
providerId string | null

Provider
pushFallbackRate string | null Required

Push fallback rate

Values are always, noRates, or never. Default value is never.
ratePreference string | null Required

Rate preference

Values are cheapest, best_value, or fastest. Default value is cheapest.
restOfWorldBandType string | null Required

Rest of world band type

Values are weight or price. Default value is price.
serviceFilteringEndpoint string | null

Service filtering endpoint
serviceLevel string | null

Service level
serviceLevelTerms string | null

Service level terms
serviceLevelToken string | null

Service level token
signatureRequired boolean | null

Signature required
source string Required

Source

Default value is Jetti.
status string | null Required

Status

Values are active or archived. Default value is active.
updatedAt string(date-time)

Updated at
useFallbackRate string | null Required

Use fallback rate

Values are always or never. Default value is always.
useIntegrationFilteringEndpoint boolean | null

Use integration filtering endpoint
useServiceFilteringEndpoint boolean | null

Use service filtering endpoint
uspsServiceLevels array[string] | null Required

Usps service levels

Default value is [] (empty).
weightMultiplication string | null Required

Weight multiplication

Values are per_shipment or per_item. Default value is per_item.

PUT /shipping-rates/{id}.json

curl \
 --request PUT 'http://api.example.com/v1/shipping-rates/{id}.json' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"allowList":false,"cacheInternalRates":false,"code":"string","createdAt":"2025-05-04T09:42:00Z","customCarriers":"all","days":42,"defaultWeight":0,"dhlExpressServiceLevels":[],"distanceUnit":"in","domesticBandType":"price","enableDiscountedDhlExpressRates":true,"enableDiscountedParcelforceRates":true,"enableDiscountedUspsRates":true,"freeShippingOverride":true,"freeShippingOverrideScope":"value","freeShippingTags":[],"freeShippingThreshold":42.0,"handlingFee":42.0,"id":42,"integrationFilteringEndpoint":"string","label":"string","maxPrice":42,"maxPriceUnit":"fixed","maximumOrderValue":42.0,"name":"string","parcelDepth":0,"parcelHeight":0,"parcelWidth":0,"parcelforceServiceLevels":[],"price":0,"priceIncrease":0,"priceType":"fixed","provider":"string","providerCode":"string","providerId":"string","pushFallbackRate":"never","ratePreference":"cheapest","restOfWorldBandType":"price","serviceFilteringEndpoint":"string","serviceLevel":"string","serviceLevelTerms":"string","serviceLevelToken":"string","signatureRequired":true,"source":"Jetti","status":"active","updatedAt":"2025-05-04T09:42:00Z","useFallbackRate":"always","useIntegrationFilteringEndpoint":true,"useServiceFilteringEndpoint":true,"uspsServiceLevels":[],"weightMultiplication":"per_item"}'

Request examples

{
  "allowList": false,
  "cacheInternalRates": false,
  "code": "string",
  "createdAt": "2025-05-04T09:42:00Z",
  "customCarriers": "all",
  "days": 42,
  "defaultWeight": 0,
  "dhlExpressServiceLevels": [],
  "distanceUnit": "in",
  "domesticBandType": "price",
  "enableDiscountedDhlExpressRates": true,
  "enableDiscountedParcelforceRates": true,
  "enableDiscountedUspsRates": true,
  "freeShippingOverride": true,
  "freeShippingOverrideScope": "value",
  "freeShippingTags": [],
  "freeShippingThreshold": 42.0,
  "handlingFee": 42.0,
  "id": 42,
  "integrationFilteringEndpoint": "string",
  "label": "string",
  "maxPrice": 42,
  "maxPriceUnit": "fixed",
  "maximumOrderValue": 42.0,
  "name": "string",
  "parcelDepth": 0,
  "parcelHeight": 0,
  "parcelWidth": 0,
  "parcelforceServiceLevels": [],
  "price": 0,
  "priceIncrease": 0,
  "priceType": "fixed",
  "provider": "string",
  "providerCode": "string",
  "providerId": "string",
  "pushFallbackRate": "never",
  "ratePreference": "cheapest",
  "restOfWorldBandType": "price",
  "serviceFilteringEndpoint": "string",
  "serviceLevel": "string",
  "serviceLevelTerms": "string",
  "serviceLevelToken": "string",
  "signatureRequired": true,
  "source": "Jetti",
  "status": "active",
  "updatedAt": "2025-05-04T09:42:00Z",
  "useFallbackRate": "always",
  "useIntegrationFilteringEndpoint": true,
  "useServiceFilteringEndpoint": true,
  "uspsServiceLevels": [],
  "weightMultiplication": "per_item"
}