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 |
| 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) |
| 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 |
| Constraint | Limit |
|---|
| Box type | Must be custom |
| Each dimension | Must be > 0 |
| Two-side combined | Cannot exceed 120 cm |
| 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 |
| 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 |
| 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 |
| Constraint | Limit |
|---|
| Total parcel weight | Must be > 0 |
| Weight per parcel | Must be > 0 |
| Each dimension | Must be > 0 |
| 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 |
| Constraint | Limit |
|---|
| Box type | Must be custom |
| Weight | Must be > 0 |
| Each dimension | Must be > 0 |
| 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 |
| 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) |
| 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 |
| 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 |
| 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 |
| 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) |
| 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 |
| 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 |
| 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³ |
| 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 |
| Constraint | Limit |
|---|
| Each dimension | Must be > 0 |
| Volume | Max 100,000 cm³ |
| Total weight | Must be > 0, max 25,000 g (25 kg) |
| Field | Required | Limit |
|---|
| SHIPMENT_NUMBER | Yes | Max 38 chars |
| DESCRIPTION | Yes | Max 255 chars |
| 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 |
| Constraint | Limit |
|---|
| Total weight | Must be > 0, max 30,000 g (30 kg) |
| Each dimension | Must be > 0, max 200 cm |
| 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 |
| 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 |
| 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 |
| Constraint | Limit |
|---|
| description | Max 20 chars |
| 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 | — |
| 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³ |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
