Options
Optional settings that affect label, delivery, taxes, and more. NOTE: create_and_buy and create_and_buy_cheapest are mutually exclusive
- additionalType: boolean | null
_handling Whether the package requires additional handling
- carbonType: boolean | null
_neutral Request carbon neutral delivery
- carrierType: number | null
_insurance _amount Declared insurance value for the carrier
- commercialType: string | null
_invoice _letterhead Header text for the commercial invoice
- commercialType: string | null
_invoice _signature Signature for the commercial invoice
- createType: boolean | null
_and _buy Immediately buy a label. Mutually exclusive with
create_and_buy_cheapest - createType: boolean | null
_and _buy _cheapest Automatically buy the cheapest rate. Mutually exclusive with
create_and_buy - deliveryType: string | null enum
_confirmation Delivery confirmation type
values- N
O _ S I G N A T U R E - S
I G N A T U R E - S
I G N A T U R E _ R E S T R I C T E D - A
D U L T _ S I G N A T U R E - A
D U L T _ S I G N A T U R E _ R E S T R I C T E D
- dropoffType: string | null Format: date_time
_max _datetime Latest acceptable drop-off time
- dropoffType: string | null
_type Dropoff type (e.g., REGULAR_PICKUP, SCHEDULED_PICKUP)
- dutyType: object | null
_payment Duties/taxes billing information
- accountType: string | null
- countryType: string | null
- postalType: string | null
_code - typeType: string enumvalues
- S
E N D E R - T
H I R D _ P A R T Y - R
E C E I V E R
- dutyType: string | null
_payment _account Account ID to use for duty/tax payment
- endorsementType: string | null
Return instruction (e.g., RETURN_SERVICE_REQUESTED)
- fetchType: boolean | null
_express _delivery _date Request express delivery date from carrier
- hazmatType: string | null enum
Indicates hazardous material
values- P
R I M A R Y _ C O N T A I N E D - P
R I M A R Y _ P A C K E D - P
R I M A R Y - S
E C O N D A R Y _ C O N T A I N E D - S
E C O N D A R Y _ P A C K E D
- incotermType: string | null
Incoterm for the shipment (e.g., DDP, DAP)
- isType: boolean | null
_return Indicates whether the shipment is a return
- labelType: string | null Format: date
_date Date to appear on the shipping label
- labelType: string | null
_format Label file format (e.g., PDF, ZPL)
- labelType: string | null
_request _source Source of the label request (e.g., api)
- labelType: string | null enum
_size Label size (e.g., 4x6)
values- 4x6
- 8
.5x11 - L
E T T E R
- machinableType: boolean | null
Whether the parcel is machinable (USPS)
- parcelsType: boolean | null
_response Whether to include parcels in the response
- paymentType: object | null
Postage billing information
- accountType: string | null
- countryType: string | null
- postalType: string | null
_code - typeType: string enumvalues
- S
E N D E R - T
H I R D _ P A R T Y - R
E C E I V E R - C
O L L E C T
- pickupType: string | null Format: date_time
_max _datetime Latest acceptable pickup time
- pickupType: string | null Format: date_time
_min _datetime Earliest acceptable pickup time
- postageType: boolean | null
_label _inline Whether to return the label inline in the response
- printType: array object[] | null
_custom Custom reference text/barcodes to print on the label. Each entry is an object. Used for carrier reference fields (e.g. UPS reference numbers, the FedEx custom print lines) and on Vesyl-rendered labels. Note that some carriers only use the first entries (e.g. FedEx uses the first two; the Vesyl-rendered label uses the first three).
- barcodeType: boolean
Whether to render the value as a barcode.
- nameType: string
Reference code for the value (carrier-specific). For UPS this is the ReferenceNumber Code; the special code "IK" sets the international commercial invoice number.
- valueType: string
Text to print on the label (or encode as a barcode).
- printType: string | null
_custom _1 Custom print field 1
- printType: string | null
_custom _2 Custom print field 2
- printType: string | null
_custom _3 Custom print field 3
- saturdayType: boolean | null
_delivery Request Saturday delivery
- specialType: string | null
_rates _eligibility Special rate plan (e.g., usps.connect)
- suppressType: boolean | null
_etd Whether to suppress estimated delivery time