Label Service Limitations - Return Helper API

Each shipping carrier enforces specific field requirements and size/weight limits when generating a return label. The tables below are derived from the validation rules in the label service source code.

Fields marked Required must be provided. Optional fields are validated only when a value is supplied. All string lengths are maximum character counts unless a range is shown.

United Kingdom

Royal Mail

Service type code: rm

Field	Required	Limit
shipFrom.country	Yes	Must be `gbr`
shipFrom.contactName	Yes	1–50 chars
shipFrom.phone	No	5–30 chars
shipFrom.fax	No	Max 50 chars
shipFrom.email	No	Max 255 chars
shipFrom.street1	Yes	1–40 chars
shipFrom.street2	No	Max 40 chars
shipFrom.street3	No	Max 50 chars
shipFrom.city	Yes	1–30 chars, no leading/trailing spaces
shipFrom.postalCode	Yes	Must match Royal Mail postcode format
shipTo.country	Yes	Must be `gbr`
shipTo.contactName	Yes	1–24 chars
shipTo.phone	No	5–30 chars
shipTo.fax	No	Max 50 chars
shipTo.email	No	Max 255 chars
shipTo.street1	Yes	1–40 chars
shipTo.street2	Yes	Max 40 chars
shipTo.street3	No	Max 50 chars
shipTo.city	Yes	1–30 chars, no leading/trailing spaces
shipTo.postalCode	Yes	Must match Royal Mail postcode format

Royal Mail (MR / BIR)

Service type code: RETURN_RM_BIR Same validation rules as Royal Mail (rm) above.

Royal Mail Postmen BIR

Service type code: RETURN_POSTMEN_RM_BIR

Field	Required	Limit
shipFrom.country	Yes	Must be `gbr`
shipFrom.contactName	Yes	Max 35 chars
shipFrom.companyName	No	Max 255 chars
shipFrom.street1	Yes	Max 60 chars
shipFrom.street2	No	Max 60 chars; combined street1+street2 max 60 chars
shipFrom.street3	No	Max 60 chars; combined street1+street2+street3 max 75 chars
shipFrom.city	Yes	Max 35 chars
shipFrom.state	No	Max 35 chars
shipFrom.postalCode	Yes	Must match Royal Mail postcode format
shipFrom.email	No	Max 255 chars, valid email format
shipFrom.phone	No	Max 255 chars
shipFrom.fax	No	Max 255 chars
shipTo.country	Yes	Must be `gbr`
shipTo.contactName	Yes	Max 35 chars
shipTo.companyName	No	Max 255 chars
shipTo.street1	Yes	Max 100 chars
shipTo.street2	No	Max 100 chars
shipTo.street3	No	Max 100 chars; combined total max 100 chars
shipTo.city	Yes	Max 35 chars
shipTo.state	No	Max 35 chars
shipTo.postalCode	Yes	Must match Royal Mail postcode format
shipTo.email	No	Max 255 chars, valid email format
shipTo.phone	No	Max 255 chars
shipTo.fax	No	Max 255 chars

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Weight per parcel	Must be > 0
Width	Max 46 cm
Height	Max 46 cm
Depth (length)	Max 90 cm
Width + height + depth	Max 104 cm (when depth > 61 cm)

Item constraints:

Constraint	Limit
Total item weight	Must be > 0
description	Required, 1–255 chars
quantity	Must be > 0
price.amount	Max 9,999,999.99
orderNumber	Required, 1–50 chars

DPD

Service type codes: pdpd, RETURN_GBR_DPD_BIR

Field	Required	Limit
shipFrom.country	Yes	Must be `gbr`
shipFrom.contactName	Yes	1–35 chars
shipFrom.companyName	No	Max 35 chars
shipFrom.street1	Yes	1–70 chars
shipFrom.street2	No	Max 69 chars
shipFrom.street3	No	Max 68 chars; combined street1+street2+street3 max 70 chars
shipFrom.city	Yes	1–30 chars, no leading/trailing spaces
shipFrom.state	No	Max 30 chars
shipFrom.postalCode	Yes	1–8 chars
shipFrom.phone	Yes	Max 15 chars
shipFrom.fax	No	Max 50 chars
shipFrom.email	No	Max 255 chars
shipTo.country	Yes	Must be `gbr`
shipTo.contactName	Yes	1–35 chars
shipTo.companyName	No	Max 35 chars
shipTo.street1	Yes	1–70 chars
shipTo.street2	No	Max 69 chars
shipTo.street3	No	Max 68 chars; combined street1+street2+street3 max 70 chars
shipTo.city	Yes	1–30 chars, no leading/trailing spaces
shipTo.state	No	Max 30 chars
shipTo.postalCode	Yes	1–8 chars
shipTo.phone	Yes	Max 15 chars
shipTo.fax	No	Max 50 chars
shipTo.email	No	Max 100 chars

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Each dimension	Must be > 0
Two-side combined	Cannot exceed 120 cm

Item constraints:

Constraint	Limit
description	Required, 1–255 chars
quantity	Must be > 0
price.amount	Must be > 0
Total item price	Must be > 0
Total item weight	Must be > 0
orderNumber	Required, 1–50 chars

DHL

Service type code: sdhl

Field	Required	Limit
shipFrom.country	Yes	—
shipFrom.companyName	Yes	Max 64 chars
shipFrom.contactName	Yes	Max 35 chars
shipFrom.street1	Yes	1–35 chars
shipFrom.street2	Yes	Max 5 chars
shipFrom.city	Yes	Max 35 chars
shipFrom.postalCode	Yes	Must match DHL postcode format
shipFrom.phone	No	Must match DHL phone format if provided
shipTo.country	Yes	—
shipTo.companyName	Yes	Max 64 chars
shipTo.contactName	Yes	Max 35 chars
shipTo.street1	Yes	1–35 chars
shipTo.street2	Yes	Max 5 chars
shipTo.city	Yes	Max 35 chars
shipTo.postalCode	Yes	Must match DHL postcode format
shipTo.phone	No	Must match DHL phone format if provided
orderNumber	No	Max 30 chars

Germany

DHL eCommerce DEU

Service type code: RETURN_DHL_ECOMMERCE_DEU

Field	Required	Limit
shipFromName (contactName + clientCode)	Yes	Max 49 chars, no `\|` character
shipFrom.companyName	No	Max 100 chars, no `\|` character
shipFrom.street1	Yes	Max 49 chars, no `\|` character
shipFrom.street2	Yes	Max 49 chars, no `\|` character
shipFrom.street3	No	Max 150 chars, no `\|` character
shipFrom.city	No	Max 30 chars, no `\|` character
shipFrom.state	No	Max 100 chars, no `\|` character
shipFrom.country	Yes	Valid country code
shipFrom.postalCode	Yes	1–10 chars
shipFrom.phone	No	Digits and `- ( ) # +` only, max 20 chars
shipFrom.email	No	Max 50 chars, no `\|` character
shipTo.companyName	Yes	Max 49 chars, no `\|` character
shipTo.street1	Yes	Max 49 chars, no `\|` character
shipTo.street2	No	Max 49 chars, no `\|` character
shipTo.street3	No	Max 150 chars, no `\|` character
shipTo.city	No	Max 30 chars, no `\|` character
shipTo.state	No	Max 50 chars, no `\|` character
shipTo.country	Yes	Valid country code
shipTo.postalCode	Yes	1–10 chars
shipTo.phone	No	Digits and `- ( ) # +` only, max 20 chars
shipTo.email	No	Max 50 chars, no `\|` character

Parcel constraints:

Constraint	Limit
Max length	120 cm
Max width	60 cm
Max height	60 cm
Each dimension	Must be > 0
description	Required, max 50 chars, no `\|` character

Item constraints:

Constraint	Limit
description	Required, max 50 chars, no `\|` character
quantity	Must be > 0
price.amount	Must be > 0.01

DHL eCommerce International DEU

Service type code: RETURN_DHL_ECOMMERCE_INTL_DEU Same validation rules as DHL eCommerce DEU above, with the following difference:

Field	Difference
shipFromName (contactName + clientCode)	Max 26 chars (vs 49 for domestic)

France

Colissimo

Service type code: ucss

Field	Required	Limit
shipFrom.country	Yes	Max 3 chars
shipFrom.contactName	Yes	Max 20 chars, French/English letters and numbers only
shipFrom.phone	Yes	Max 15 chars
shipFrom.email	No	Max 80 chars, valid email format
shipFrom.street1	Yes	Max 22 chars
shipFrom.street2	No	Max 22 chars
shipFrom.street3	No	Max 22 chars
shipFrom.city	Yes	Max 35 chars
shipFrom.postalCode	Yes	Max 5 chars
shipTo.companyName	Yes	Max 32 chars
shipTo.contactName	Yes	Max 32 chars
shipTo.phone	Yes	Max 15 chars
shipTo.email	Yes	Max 80 chars, valid email format
shipTo.street1	Yes	Max 35 chars
shipTo.street2	No	Max 35 chars
shipTo.street3	No	Max 35 chars
shipTo.country	Yes	Max 3 chars
shipTo.city	Yes	Max 35 chars
shipTo.postalCode	Yes	Max 5 chars
shipmentDate	Yes	—

FREU-Colissimo

Service type code: RETURN_PATRICE_EUR

Field	Required	Limit
shipFrom.country	Yes	Valid country code
shipFrom.contactName	Yes	Max 35 chars
shipFrom.phone	Yes	Max 20 chars
shipFrom.email	No	Max 80 chars, valid email format
shipFrom.street1	Yes	Max 35 chars
shipFrom.street2	No	Max 35 chars
shipFrom.street3	No	Max 35 chars
shipFrom.city	Yes	Max 30 chars
shipFrom.postalCode	Yes	Max 10 chars
shipTo.companyName	Yes	Max 35 chars
shipTo.contactName	Yes	Max 35 chars
shipTo.phone	Yes	Max 20 chars
shipTo.email	Yes	Max 80 chars, valid email format
shipTo.street1	Yes	Max 35 chars
shipTo.street2	No	Max 35 chars
shipTo.street3	No	Max 35 chars
shipTo.country	Yes	Valid country code
shipTo.city	Yes	Max 25 chars
shipTo.postalCode	Yes	Max 5 chars
shipmentDate	Yes	—

FREU-DHL

Service type code: RETURN_PATRICE_DHL_EUR

Field	Required	Limit
shipFrom.contactName	Yes	Max 50 chars
shipFrom.companyName	Yes	Max 50 chars
shipFrom.country	Yes	Valid country code
shipFrom.street1	Yes	Max 70 chars
shipFrom.street2	No	Max 70 chars
shipFrom.street3	No	Max 70 chars; combined street1+street2+street3 max 90 chars
shipFrom.city	Yes	Max 40 chars
shipFrom.postalCode	Yes	Max 10 chars
shipFrom.phone	No	Max 20 chars
shipFrom.email	No	Max 70 chars, valid email format
shipTo.contactName	Yes	Max 49 chars
shipTo.companyName	Yes	Max 50 chars
shipTo.country	Yes	Valid country code
shipTo.street1	Yes	Max 45 chars
shipTo.street2	No	Max 35 chars
shipTo.street3	No	Max 35 chars
shipTo.city	Yes	Max 45 chars
shipTo.postalCode	Yes	Max 10 chars
shipTo.phone	Yes	Max 20 chars
shipTo.email	No	Max 70 chars, valid email format
shipmentDate	Yes	—

Chronopost (France)

Service type code: RETURN_ATOMICSELLER_CHRONOPOST_FRA

Field	Required	Limit
shipFrom.contactName	Yes	Max 40 chars
shipFrom.companyName	Yes	Max 40 chars
shipFrom.street1	Yes	Max 35 chars; combined street1+street2+street3 max 35 chars
shipFrom.country	Yes	Valid country code
shipFrom.city	Yes	Max 33 chars
shipFrom.postalCode	Yes	Max 5 chars
shipFrom.phone	Yes	Max 17 chars
shipFrom.email	No	Max 80 chars, valid email format
shipTo.contactName	Yes	Max 34 chars
shipTo.companyName	Yes	Max 47 chars
shipTo.street1	Yes	Max 38 chars
shipTo.street2	No	Max 38 chars
shipTo.street3	No	Max 38 chars
shipTo.country	Yes	Valid country code
shipTo.city	Yes	Max 49 chars
shipTo.postalCode	Yes	Max 5 chars
shipTo.phone	Yes	Max 17 chars
shipTo.email	No	Max 80 chars, valid email format

Parcel constraints:

Constraint	Limit
Total parcel weight	Must be > 0
Weight per parcel	Must be > 0
Each dimension	Must be > 0

Item constraints:

Constraint	Limit
price.amount	Must be > 0

Spain

Correos

Service type code: ucepaq

Field	Required	Limit
shipFrom.country	Yes	Must be `esp`
shipFrom.contactName	Yes	1–50 chars
shipFrom.companyName	No	1–50 chars
shipFrom.phone	Yes	Must match Correos phone format
shipFrom.fax	No	1–50 chars
shipFrom.email	No	1–255 chars
shipFrom.street1	Yes	1–35 chars
shipFrom.street2	No	1–35 chars
shipFrom.street3	No	1–35 chars
shipFrom.city	No	1–50 chars
shipFrom.state	No	1–50 chars
shipFrom.postalCode	Yes	Must match Correos postcode format
shipTo.country	Yes	Must be `esp`
shipTo.contactName	Yes	1–100 chars
shipTo.companyName	No	1–50 chars
shipTo.phone	Yes	Must match Correos phone format
shipTo.fax	No	1–50 chars
shipTo.email	No	1–255 chars
shipTo.street1	Yes	1–35 chars
shipTo.street2	No	1–35 chars
shipTo.street3	No	1–35 chars
shipTo.city	No	1–50 chars
shipTo.state	No	1–50 chars
shipTo.postalCode	Yes	Must match Correos postcode format

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Weight	Must be > 0
Each dimension	Must be > 0

Item constraints:

Constraint	Limit
description	Required, 1–255 chars
quantity	Must be > 0
price.currency	Must be `USD`
price.amount	Must be > 0
orderNumber	Required, 1–50 chars

United States — New Jersey (NJ) Warehouse

UPS Ground-NJ

Service type code: ups_nj

Field	Required	Limit
shipFrom.country	Yes	Must be `usa`
shipFrom.contactName	Yes	1–30 chars
shipFrom.companyName	No	Max 30 chars
shipFrom.street1	Yes	1–30 chars
shipFrom.street2	No	Max 30 chars
shipFrom.street3	No	Max 30 chars; combined street1+street2+street3 max 30 chars
shipFrom.city	Yes	1–30 chars
shipFrom.state	Yes	Exactly 2 chars
shipFrom.postalCode	Yes	Must match UPS US postcode format
shipFrom.phone	Yes	Must match UPS phone format
shipFrom.fax	No	Max 50 chars
shipFrom.email	No	Max 255 chars
shipTo.country	Yes	Must be `usa`
shipTo.contactName	Yes	1–35 chars
shipTo.companyName	No	Max 35 chars
shipTo.street1	Yes	1–90 chars
shipTo.street2	No	Max 90 chars
shipTo.street3	No	Max 90 chars; combined street1+street2+street3 max 90 chars
shipTo.city	Yes	1–30 chars
shipTo.state	Yes	Exactly 2 chars
shipTo.postalCode	Yes	Must match UPS US postcode format
shipTo.phone	Yes	Must match UPS phone format
shipTo.fax	No	Max 50 chars
shipTo.email	No	Max 255 chars

Parcel constraints:

Constraint	Limit
Each dimension	Must be > 0
Max single dimension	270 cm
Length + girth	Max 415 cm
Total weight	Must be > 0, max 440,000 g (440 kg)

Item constraints:

Constraint	Limit
description	Required, 1–255 chars
quantity	Must be > 0
price.amount	Must be > 0
orderNumber	Required, 1–50 chars

USPS-NJ

Service type code: usps

Field	Required	Limit
shipFrom.contactName	Yes	1–32 chars
shipFrom.street1	Yes	1–32 chars
shipFrom.street2	No	Max 32 chars
shipFrom.city	Yes	1–20 chars
shipFrom.state	Yes	Exactly 2 chars
shipFrom.postalCode	Yes	Must match USPS ZIP format
shipFrom.email	Yes	Valid email format
shipTo.street1	No	Max 48 chars
shipTo.street2	No	Max 48 chars
shipTo.city	No	Max 48 chars
shipTo.state	No	Exactly 2 chars (if provided)
shipTo.postalCode	Yes	Exactly 5 digits
shipTo.email	Yes	Valid email format

Item constraints:

Constraint	Limit
item.weight	Must be > 0

USPS-BROKER-NJ

Service type code: RETURN_USPS_BROKER_NJ Same validation rules as USPS-NJ (usps) above.

USPS Broker Priority Mail-NJ

Service type code: RETURN_USPS_BROKER_PM_NJ Same address and parcel validation rules as Stamps/Endicia (NJ/WA services) below. Length + girth max 274 cm.

USPS Broker Ground Advantage-NJ

Service type code: RETURN_USPS_BROKER_GA_NJ Same address and parcel validation rules as Stamps/Endicia (NJ/WA services) below. Length + girth max 330 cm.

USPS Priority Mail-NJ

Service type code: RETURN_USPS_NJ

Field	Required	Limit
shipFrom.contactName	Yes	Max 43 chars, must be at least 2 words
shipFrom.street1	Yes	Max 50 chars
shipFrom.street2	No	Max 50 chars
shipFrom.city	Yes	Max 28 chars
shipFrom.state	Yes	Exactly 2 chars
shipFrom.postalCode	Yes	Must match USPS ZIP format
shipTo.companyName	Yes	Max 38 chars, must be at least 2 words
shipTo.street1	Yes	Max 38 chars
shipTo.street2	No	Max 38 chars
shipTo.city	Yes	Max 28 chars
shipTo.state	Yes	Exactly 2 chars
shipTo.postalCode	Yes	Must match USPS ZIP format

Parcel constraints:

Constraint	Limit
Each dimension	Must be > 0
Weight	Must be > 0
Length + girth	Max 274 cm

USPS Ground Advantage-NJ

Service type code: RETURN_ENDICIA_USPS_GROUND_ADVANTAGE_NJ Same address validation rules as USPS Priority Mail-NJ above, with different parcel constraints: Parcel constraints:

Constraint	Limit
Each dimension	Must be > 0
Weight	Must be > 0
Length + girth	Max 330 cm

FedEx Ground-NJ

Service type code: fedex_ground

Field	Required	Limit
shipFrom.country	Yes	Must be `usa`
shipFrom.contactName	Yes	Max 30 chars
shipFrom.companyName	No	Max 30 chars
shipFrom.street1	Yes	Max 30 chars
shipFrom.street2	No	Max 30 chars; combined street1+street2 max 30 chars (when no street3)
shipFrom.street3	No	Max 29 chars; combined street1+street2+street3 max 29 chars
shipFrom.state	Yes	Exactly 2 chars
shipFrom.postalCode	Yes	Must match FedEx US postcode format
shipFrom.phone	Yes	Must match FedEx phone format
shipFrom.fax	No	Max 16 chars
shipFrom.email	No	Valid email format
shipTo.country	Yes	Must be `usa`
shipTo.contactName	Yes	Max 35 chars
shipTo.companyName	No	Max 35 chars
shipTo.street1	Yes	Max 30 chars
shipTo.street2	No	Max 34 chars; combined street1+street2 max 34 chars (when no street3)
shipTo.street3	No	Max 33 chars; combined street1+street2+street3 max 33 chars
shipTo.state	Yes	Exactly 2 chars
shipTo.postalCode	Yes	Must match FedEx US postcode format
shipTo.phone	Yes	Max 30 chars, must match FedEx phone format
shipTo.fax	No	Max 16 chars
shipTo.email	No	Valid email format

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Each dimension	Must be > 0
Max length (longest side)	274 cm
Length + girth	Max 419 cm
Max weight	68,000 g (68 kg)

Item constraints:

Constraint	Limit
description	Required, 1–255 chars
quantity	Must be > 0
price.amount	Must be > 0
Total item weight	Must be > 0
orderNumber	Required, 1–50 chars

DHL Parcel Ground-NJ

Service type code: RETURN_DHL_PARCEL_GROUND_NJ

Field	Required	Limit
shipFrom.contactName	Yes	1–50 chars
shipFrom.companyName	Yes	1–30 chars
shipFrom.street1	Yes	1–50 chars
shipFrom.street2	No	Max 50 chars
shipFrom.street3	No	Max 50 chars
shipFrom.city	Yes	Max 40 chars
shipFrom.state	Yes	Exactly 2 chars
shipFrom.postalCode	Yes	Must match format `XXXXX` or `XXXXX-XXXX`
shipFrom.email	No	Max 50 chars
shipFrom.phone	No	Max 26 chars
shipTo.contactName	Yes	1–38 chars
shipTo.companyName	Yes	1–30 chars
shipTo.street1	Yes	1–40 chars
shipTo.street2	No	Max 40 chars
shipTo.street3	No	Max 50 chars
shipTo.city	Yes	Max 26 chars
shipTo.state	Yes	Exactly 2 chars
shipTo.postalCode	Yes	Must match format `XXXXX` or `XXXXX-XXXX`
shipTo.email	No	Max 50 chars
shipTo.phone	No	Max 26 chars

Stamps/Endicia (NJ/WA services)

Applies to: RETURN_USPS_NJ, RETURN_ENDICIA_USPS_GROUND_ADVANTAGE_NJ, RETURN_USPS_BROKER_PM_NJ, RETURN_USPS_BROKER_GA_NJ, RETURN_USPS_BROKER_PM_WA, RETURN_USPS_BROKER_GA_WA These services pass through the Stamps/Endicia validator:

Field	Required	Limit
shipFrom.companyName	No	Max 50 chars
shipFrom.contactName	Yes	Max 100 chars
shipFrom.street1	Yes	Max 50 chars
shipFrom.street2	No	Max 50 chars
shipFrom.street3	No	Max 100 chars
shipFrom.city	Yes	Max 50 chars
shipFrom.state	Yes	Max 50 chars
shipFrom.postalCode	Yes	Max 14 chars
shipFrom.country	Yes	Must be `usa`
shipFrom.phone	Yes	Max 30 chars
shipFrom.email	Yes	Max 50 chars, valid email format
shipTo.companyName	No	Max 50 chars
shipTo.contactName	Yes	Max 100 chars
shipTo.street1	Yes	Max 50 chars
shipTo.street2	No	Max 50 chars
shipTo.street3	No	Max 100 chars
shipTo.city	Yes	Max 50 chars
shipTo.state	Yes	Max 50 chars
shipTo.postalCode	Yes	Max 14 chars
shipTo.country	Yes	Must be `usa`
shipTo.phone	Yes	Max 30 chars
shipTo.email	Yes	Max 50 chars, valid email format
orderNumber	No	Max 50 chars

Parcel constraints:

Constraint	Limit
Each dimension	Must be > 0
Weight per parcel	Must be > 0
Total weight	Max 31,751 g (~31.75 kg / 70 lbs)
Length + girth (Ground Advantage)	Max 330 cm
Length + girth (Priority Mail)	Max 274 cm

United States — Washington (WA) Warehouse

UPS Ground-WA

Service type code: ups_wa Same validation rules as UPS Ground-NJ above.

USPS Priority Mail-WA

Service type code: endicia Same validation rules as USPS Priority Mail-NJ and Stamps/Endicia (NJ services) above. Length + girth max 274 cm.

USPS Parcel Select-WA

Service type code: endicia_parcel_select Same address validation rules as USPS Priority Mail-WA above. Length + girth max 330 cm (Ground Advantage limits apply).

USPS Ground Advantage-WA

Service type code: RETURN_ENDICIA_USPS_GROUND_ADVANTAGE_WA Same address validation rules as USPS Priority Mail-WA above. Length + girth max 330 cm.

DHL Parcel Ground-WA

Service type code: RETURN_DHL_PARCEL_GROUND_WA Same validation rules as DHL Parcel Ground-NJ above.

FedEx Ground-WA

Service type code: RETURN_FEDEX_GROUND_WA Same validation rules as FedEx Ground-NJ above.

USPS Broker Priority Mail-WA

Service type code: RETURN_USPS_BROKER_PM_WA Same address and parcel validation rules as Stamps/Endicia (NJ/WA services) above. Length + girth max 274 cm.

USPS Broker Ground Advantage-WA

Service type code: RETURN_USPS_BROKER_GA_WA Same address and parcel validation rules as Stamps/Endicia (NJ/WA services) above. Length + girth max 330 cm.

Australia

AU Post

Service type code: ubi_au

Field	Required	Limit
shipFrom.contactName	Yes	Max 35 chars
shipFrom.email	No	Max 50 chars
shipFrom.phone	No	Max 20 chars
shipFrom.street1	Yes	Max 40 chars
shipFrom.street2	No	Max 60 chars
shipFrom.street3	No	Max 80 chars
shipFrom.city	Yes	Max 80 chars
shipFrom.state	Yes	Max 80 chars
shipFrom.postalCode	Yes	Max 16 chars
shipTo.companyName	Yes	Max 50 chars

Parcel constraints:

Constraint	Limit
Total weight	Must be > 0, max 22,000 g (22 kg)
Each dimension	Must be > 0, max 105 cm
Volume	Must be > 0, max 250,000 cm³

Custom field constraints:

Field	Required	Limit
DESCRIPTION	Yes	Max 50 chars

Sendle AU Domestic

Service type code: sendle_au_domestic

Field	Required	Limit
shipFrom.contactName	Yes	Max 20 chars (single word) or max 40 chars (with space)
shipFrom.companyName	No	Max 20 chars (single word) or max 40 chars (with space)
shipFrom.phone	No	Max 14 chars
shipFrom.street1	Yes	Max 45 chars
shipFrom.street2	No	Max 45 chars
shipFrom.city	Yes	Max 30 chars
shipFrom.state	Yes	Max 3 chars
shipFrom.postalCode	Yes	Must match Sendle postcode format
shipFrom.country	No	Max 50 chars
shipTo.contactName	Yes	Max 38 chars
shipTo.companyName	No	Max 34 chars
shipTo.email	No	Valid email format
shipTo.phone	No	Max 14 chars, numeric
shipTo.street1	Yes	Max 66 chars
shipTo.street2	No	Max 66 chars
shipTo.city	Yes	Max 30 chars
shipTo.state	Yes	Max 3 chars
shipTo.postalCode	Yes	Must match Sendle postcode format

Parcel constraints:

Constraint	Limit
Each dimension	Must be > 0
Volume	Max 100,000 cm³
Total weight	Must be > 0, max 25,000 g (25 kg)

Custom field constraints:

Field	Required	Limit
SHIPMENT_NUMBER	Yes	Max 38 chars
DESCRIPTION	Yes	Max 255 chars

Other constraints:

Constraint	Limit
orderNumber	Max 110 chars

Canada

Canada Post

Service type code: ubi_ca

Field	Required	Limit
shipFrom.contactName	Yes	Max 50 chars
shipFrom.email	Yes	Max 50 chars
shipFrom.phone	Yes	Max 20 chars
shipFrom.street1	Yes	Max 45 chars
shipFrom.street2	No	Max 41 chars
shipFrom.street3	No	Max 80 chars
shipFrom.city	Yes	Max 50 chars
shipFrom.state	Yes	Max 80 chars
shipFrom.postalCode	Yes	Max 16 chars
shipTo.companyName	Yes	Max 42 chars

Parcel constraints:

Constraint	Limit
Total weight	Must be > 0, max 30,000 g (30 kg)
Each dimension	Must be > 0, max 200 cm

Custom field constraints:

Field	Required	Limit
DESCRIPTION	Yes	1–50 chars, must start with a letter, only letters, numbers, `#`, `/`, `-`, `_`, `(`, `)` allowed

Hong Kong / Asia

SF Express

Service type code: sf_hk

Field	Required	Limit
shipFrom.companyName	No	Max 45 chars
shipFrom.contactName	No	Max 30 chars
shipFrom.phone	No	Must match SF Express phone format if provided
shipFrom.street1	Yes	Max 40 chars (if no street2); combined with street2 max 40 chars
shipFrom.city	No	Max 100 chars
shipFrom.postalCode	No	Max 25 chars
shipFrom.email	No	Max 200 chars
shipTo.companyName	No	Max 30 chars
shipTo.contactName	No	Max 8 chars
shipTo.phone	No	Must match SF Express phone format if provided
shipTo.street1	Yes	Max 40 chars (if no street2); combined with street2 max 40 chars
shipTo.city	No	Max 100 chars
shipTo.postalCode	No	Max 25 chars
shipTo.email	No	Max 200 chars

Item constraints:

Constraint	Limit
description	Required, max 128 chars
price.amount	Precision 17, scale 3
price.currency	Max 5 chars
orderNumber	Required, max 30 chars

Taiwan

Yamato

Service type code: RETURN_YAMATO_TWN

Field	Required	Limit
shipFrom.contactName	Yes	Max 30 chars, Chinese/English/digits/common special characters only
shipFrom.phone	Yes	Must start with `09` and be exactly 10 digits
shipFrom.city	Yes	—
shipFrom.city + street1 + street2 + street3	—	Combined max 120 chars
shipTo.companyName	Yes	Combined with clientCode max 30 chars
shipTo.phone	Yes	Must start with `09` and be exactly 10 digits
shipTo.city	Yes	—
shipTo.city + street1 + street2 + street3	—	Combined max 120 chars

Parcel constraints:

Constraint	Limit
Total parcel weight	Must be > 0, max 20,000 g (20 kg)
Weight per parcel	Must be > 0, max 20,000 g (20 kg)
Total dimensions (L+W+H)	Max 150 cm

Item constraints:

Constraint	Limit
description	Max 20 chars

Custom field constraints:

Field	Required	Limit
DESCRIPTION	Yes	Max 100 chars

Southeast Asia

Qxpress (Singapore)

Service type code: easyparcel_qxpress

Field	Required	Limit
shipFrom.contactName	Yes	—
shipFrom.street1	Yes	—
shipFrom.city	Yes	—
shipFrom.state	Yes	—
shipFrom.postalCode	Yes	Exactly 6 chars
shipFrom.country	Yes	—
shipTo.contactName	Yes	Max 45 chars
shipTo.companyName	Yes	Max 45 chars
shipTo.phone	Yes	Max 16 chars
shipTo.street1	Yes	Max 100 chars; combined with street2 max 100 chars
shipTo.city	Yes	—
shipTo.state	Yes	—
shipTo.postalCode	Yes	Exactly 6 chars
shipTo.country	Yes	—

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Weight per parcel	Must be > 0
Total weight	Must be > 0
Each dimension	Must be > 0, max 80 cm
Total of all three dimensions	Max 240 cm
Volume	Max 150,000 cm³

Item constraints:

Constraint	Limit
description	Required, max 35 chars
price.amount	Must be > 0

J&T Express (Malaysia)

Service type code: easyparcel_jnt_express

Field	Required	Limit
shipFrom.street1	Yes	Max 100 chars; combined with street2 max 100 chars
shipFrom.city	Yes	Max 35 chars
shipFrom.postalCode	Yes	Max 10 chars
shipFrom.country	Yes	Max 35 chars
shipFrom.contactName	No	Max 35 chars
shipFrom.phone	Yes	Max 16 chars, must match EasyParcel MY phone format
shipTo.contactName	Yes	Max 20 chars
shipTo.companyName	Yes	Max 30 chars
shipTo.phone	Yes	Max 16 chars, must match EasyParcel MY phone format
shipTo.street1	Yes	Max 100 chars; combined with street2 max 100 chars
shipTo.city	Yes	Max 35 chars
shipTo.postalCode	Yes	Max 10 chars
shipTo.country	Yes	Max 35 chars

Item constraints:

Constraint	Limit
Total weight	Max 30,000 g (30 kg)
description	Required, max 35 chars
price.amount	Required

DHL eCommerce (Malaysia)

Service type code: RETURN_DHL_ECOMMERC_MYS

Field	Required	Limit
shipFrom.street1	Yes	Max 100 chars; combined with street2 max 100 chars
shipFrom.city	Yes	Max 35 chars
shipFrom.postalCode	Yes	Max 10 chars
shipFrom.country	Yes	Max 35 chars
shipFrom.contactName	No	Max 35 chars (used as pick-up name)
shipFrom.phone	Yes	Max 16 chars, must match EasyParcel MY phone format
shipTo.contactName	Yes	Max 20 chars
shipTo.companyName	Yes	Max 30 chars
shipTo.phone	Yes	Max 16 chars, must match EasyParcel MY phone format
shipTo.street1	Yes	Max 100 chars; combined with street2 max 100 chars
shipTo.city	Yes	Max 35 chars
shipTo.postalCode	Yes	Max 10 chars
shipTo.country	Yes	Max 35 chars

Item constraints:

Constraint	Limit
Total weight	Max 30,000 g (30 kg)
description	Required, max 35 chars
price.amount	Required

Singapore Post (EZY2SHIP)

Service type code: RETURN_SGPPOST_EZY2SHIP

Field	Required	Limit
shipFrom.contactName	Yes	Max 35 chars
shipFrom.companyName	Yes	Max 35 chars
shipFrom.street1	Yes	Max 35 chars
shipFrom.street2	No	Max 35 chars
shipFrom.street3	No	Max 35 chars
shipFrom.city	Yes	Max 30 chars
shipFrom.state	Yes	Max 30 chars
shipFrom.postalCode	Yes	Must match Singapore Post postcode format
shipFrom.phone	Yes	Max 20 chars
shipFrom.fax	No	Max 255 chars
shipFrom.country	Yes	Max 3 chars
shipTo.contactName	Yes	Max 35 chars
shipTo.companyName	Yes	Max 35 chars
shipTo.street1	Yes	Max 35 chars
shipTo.street2	No	Max 35 chars
shipTo.street3	No	Max 35 chars
shipTo.city	Yes	Max 30 chars
shipTo.state	Yes	Max 30 chars
shipTo.postalCode	Yes	Must match Singapore Post postcode format
shipTo.email	No	Max 100 chars, valid email format
shipTo.phone	Yes	Max 20 chars
shipTo.country	Yes	Max 3 chars

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Total parcel weight	Must be > 0, max 100,000 g (100 kg)
Weight per parcel	Must be > 0, max 100,000 g (100 kg)
Width	Must be > 0
Height	Must be > 0
Length	Must be > 0

Item constraints:

Constraint	Limit
Total item weight	Must be > 0, max 100,000 g (100 kg)
description	Max 50 chars
quantity	Must be > 0, max 999,999
weight per item	Must be > 0, max 100,000 g
price.currency	Required, 3 chars
price.amount	Must be >= 0
orderNumber	Required, 1–50 chars

Spaceship

Spaceship UPS

Service type code: RETURN_SPACESHIP_UPS

Field	Required	Limit
shipFrom.contactName	Yes	Max 35 chars
shipFrom.companyName	Yes	Max 35 chars
shipFrom.street1	Yes	Max 70 chars
shipFrom.street2	No	Max 50 chars; combined street1+street2 max 96 chars
shipFrom.city	Yes	Max 30 chars
shipFrom.state	No	Max 80 chars
shipFrom.postalCode	Yes	Max 9 chars
shipFrom.country	Yes	Max 3 chars
shipFrom.phone	Yes	Max 20 chars
shipFrom.email	No	Max 81 chars, valid email format
shipFrom.fax	No	Max 255 chars
shipTo.contactName	Yes	Max 35 chars
shipTo.companyName	Yes	Max 35 chars
shipTo.street1	Yes	Max 70 chars
shipTo.street2	No	Max 50 chars; combined street1+street2 max 96 chars
shipTo.city	Yes	Max 30 chars
shipTo.state	No	Max 80 chars
shipTo.postalCode	Yes	Max 9 chars
shipTo.country	Yes	Max 3 chars
shipTo.phone	Yes	Max 20 chars
shipTo.email	No	Max 81 chars, valid email format

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Weight per parcel	Must be > 0
Total weight	Must be > 0
Each dimension	Must be > 0, whole numbers only
Max length (longest side)	274 cm
Total dimensions (L+W+H)	Max 302 cm
Length + girth	Max 400 cm

Item constraints:

Constraint	Limit
description	Required, max 35 chars
quantity	Must be > 0, max 999,999,999
price.amount	Must be >= 0
Total item weight	Must be > 0

Spaceship DHL

Service type code: RETURN_SPACESHIP_DHL

Field	Required	Limit
shipFrom.contactName	Yes	Max 200 chars
shipFrom.companyName	Yes	Max 100 chars
shipFrom.street1	Yes	Max 70 chars
shipFrom.street2	No	Max 50 chars; combined street1+street2 max 96 chars
shipFrom.city	Yes	Max 30 chars
shipFrom.state	No	Max 35 chars
shipFrom.postalCode	Yes	Max 9 chars
shipFrom.country	Yes	Max 3 chars
shipFrom.phone	Yes	Max 20 chars
shipFrom.email	No	Max 81 chars, valid email format
shipFrom.fax	No	Max 255 chars
shipTo.contactName	Yes	Max 200 chars
shipTo.companyName	Yes	Max 100 chars
shipTo.street1	Yes	Max 70 chars
shipTo.street2	No	Max 50 chars; combined street1+street2 max 96 chars
shipTo.city	Yes	Max 30 chars
shipTo.state	No	Max 35 chars
shipTo.postalCode	Yes	Max 9 chars
shipTo.country	Yes	Max 3 chars
shipTo.phone	Yes	Max 20 chars
shipTo.email	No	Max 70 chars, valid email format

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Weight per parcel	Must be > 0
Total weight	Must be > 0
Each dimension	Must be > 0, whole numbers only
Max length (longest side)	303 cm
Total dimensions (L+W+H)	Max 789 cm

Item constraints:

Constraint	Limit
description	Required, max 35 chars
quantity	Must be > 0, max 999,999,999
price.amount	Must be >= 0
Total item weight	Must be > 0
Total item price	Must be >= 0

Spaceship FedEx

Service type code: RETURN_SPACESHIP_FEDEX

Field	Required	Limit
shipFrom.contactName	Yes	Max 200 chars
shipFrom.companyName	Yes	Max 100 chars
shipFrom.street1	Yes	Max 70 chars
shipFrom.street2	No	Max 50 chars; combined street1+street2 max 96 chars
shipFrom.city	Yes	Max 100 chars
shipFrom.state	No	Max 80 chars
shipFrom.postalCode	Yes	Max 10 chars
shipFrom.country	Yes	Max 3 chars
shipFrom.phone	Yes	Max 20 chars
shipFrom.email	No	Max 81 chars, valid email format
shipFrom.fax	No	Max 255 chars
shipTo.contactName	Yes	Max 200 chars
shipTo.companyName	Yes	Max 100 chars
shipTo.street1	Yes	Max 70 chars
shipTo.street2	No	Max 50 chars; combined street1+street2 max 96 chars
shipTo.city	Yes	Max 100 chars
shipTo.state	No	Max 80 chars
shipTo.postalCode	Yes	Max 10 chars
shipTo.country	Yes	Max 3 chars
shipTo.phone	Yes	Max 20 chars
shipTo.email	No	Max 81 chars, valid email format

Parcel constraints:

Constraint	Limit
Box type	Must be `custom`
Weight per parcel	Must be > 0
Total weight	Must be > 0
Each dimension	Must be > 0, whole numbers only
Max length (longest side)	274 cm
Total dimensions (L+W+H)	Max 302 cm

Item constraints:

Constraint	Limit
description	Required, max 35 chars
quantity	Must be > 0, max 999,999,999
price.amount	Must be >= 0
Total item weight	Must be > 0
Total item price	Must be >= 0

​United Kingdom

​Royal Mail

​Royal Mail (MR / BIR)

​Royal Mail Postmen BIR

​DPD

​DHL

​Germany

​DHL eCommerce DEU

​DHL eCommerce International DEU

​France

​Colissimo

​FREU-Colissimo

​FREU-DHL

​Chronopost (France)

​Spain

​Correos

​United States — New Jersey (NJ) Warehouse

​UPS Ground-NJ

​USPS-NJ

​USPS-BROKER-NJ

​USPS Broker Priority Mail-NJ

​USPS Broker Ground Advantage-NJ

​USPS Priority Mail-NJ

​USPS Ground Advantage-NJ

​FedEx Ground-NJ

​DHL Parcel Ground-NJ

​Stamps/Endicia (NJ/WA services)

​United States — Washington (WA) Warehouse

​UPS Ground-WA

​USPS Priority Mail-WA

​USPS Parcel Select-WA

​USPS Ground Advantage-WA

​DHL Parcel Ground-WA

​FedEx Ground-WA

​USPS Broker Priority Mail-WA

​USPS Broker Ground Advantage-WA

​Australia

​AU Post

​Sendle AU Domestic

​Canada

​Canada Post

​Hong Kong / Asia

​SF Express

​Taiwan

​Yamato

​Southeast Asia

​Qxpress (Singapore)

​J&T Express (Malaysia)

​DHL eCommerce (Malaysia)

​Singapore Post (EZY2SHIP)

​Spaceship

​Spaceship UPS

​Spaceship DHL

​Spaceship FedEx

United Kingdom

Royal Mail

Royal Mail (MR / BIR)

Royal Mail Postmen BIR

DPD

DHL

Germany

DHL eCommerce DEU

DHL eCommerce International DEU

France

Colissimo

FREU-Colissimo

FREU-DHL

Chronopost (France)

Spain

Correos

United States — New Jersey (NJ) Warehouse

UPS Ground-NJ

USPS-NJ

USPS-BROKER-NJ

USPS Broker Priority Mail-NJ

USPS Broker Ground Advantage-NJ

USPS Priority Mail-NJ

USPS Ground Advantage-NJ

FedEx Ground-NJ

DHL Parcel Ground-NJ

Stamps/Endicia (NJ/WA services)

United States — Washington (WA) Warehouse

UPS Ground-WA

USPS Priority Mail-WA

USPS Parcel Select-WA

USPS Ground Advantage-WA

DHL Parcel Ground-WA

FedEx Ground-WA

USPS Broker Priority Mail-WA

USPS Broker Ground Advantage-WA

Australia

AU Post

Sendle AU Domestic

Canada

Canada Post

Hong Kong / Asia

SF Express

Taiwan

Yamato

Southeast Asia

Qxpress (Singapore)

J&T Express (Malaysia)

DHL eCommerce (Malaysia)

Singapore Post (EZY2SHIP)

Spaceship

Spaceship UPS

Spaceship DHL

Spaceship FedEx