{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"address_from": {
"description": "Address From"
},
"address_return": {
"description": "Address Return"
},
"address_to": {
"description": "Address To"
},
"async": {
"type": "boolean",
"description": "The async value"
},
"carrier_accounts": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of <a href=\"/shippoapi/public-api/carrier-accounts\">Carrier Accounts</a> `object_id`s used to filter the returned rates. If set, only rates from these carriers will be returned."
},
"customs_declaration": {
"description": "Customs Declaration"
},
"extra": {
"type": "object",
"description": "An object holding optional extra services to be requested.",
"properties": {
"accounts_receivable_customer_account": {
"description": "Accounts Receivable Customer Account"
},
"alcohol": {
"type": "object",
"description": "Indicates that a shipment contains Alcohol (Fedex and UPS only)."
},
"ancillary_endorsement": {
"description": "Specify an ancillary service endorsement to provide the USPS with instructions on how to handle undeliverable-as-addressed pieces (DHL eCommerce only)."
},
"appropriation_number": {
"description": "Appropriation Number"
},
"authority_to_leave": {
"type": "boolean",
"description": "Request `true` to give carrier permission to leave the parcel in a safe place if no one answers the door (where supported). When set to `false`, if no one is available to receive the item, the parcel will not be left (*surcharges may be applicable)."
},
"bill_of_lading_number": {
"description": "Bill Of Lading Number"
},
"billing": {
"type": "object",
"description": "Specify billing details (UPS, FedEx, and DHL Germany only)."
},
"bypass_address_validation": {
"type": "boolean",
"description": "Bypasses address validation (USPS, UPS, & LaserShip only)."
},
"carbon_neutral": {
"type": "boolean",
"description": "Request carbon offsets by passing true (UPS only)."
},
"carrier_hub_id": {
"type": "string",
"description": "Identifies the carrier injection site."
},
"carrier_hub_travel_time": {
"type": "integer",
"description": "Travel time in hours from fulfillment center to carrier injection site."
},
"COD": {
"type": "object",
"description": "Specify collection on delivery details (UPS only)."
},
"cod_number": {
"description": "Cod Number"
},
"container_type": {
"type": "string",
"description": "Specify container type."
},
"critical_pull_time": {
"type": "string",
"description": "Carrier arrival time to pickup packages from the fulfillment center. UTC format: `%Y-%m-%dT%H:%M:%SZ`"
},
"customer_branch": {
"type": "string",
"description": "Specify customer branch (Lasership only)."
},
"customer_reference": {
"type": "object",
"description": "Specify the reference field on the label (FedEx and UPS only)."
},
"dangerous_goods": {
"type": "object",
"description": "Container for specifying the presence of dangerous materials. This is specific to USPS, and if any contents are provided, only certain USPS service levels will be eligible. For more information, see our <a href=\"https://docs.goshippo.com/docs/shipments/hazmat/\">guide on hazardous or dangerous materials shipping</a>."
},
"dangerous_goods_code": {
"description": "Dangerous Goods Code (DHL eCommerce only). See <a href=\"https://api-legacy.dhlecs.com/docs/v2/appendix.html#dangerous-goods\">Category Codes</a>"
},
"dealer_order_number": {
"description": "Dealer Order Number"
},
"delivery_instructions": {
"type": "string",
"description": "Specify delivery instructions. Up to 500 characters. (FedEx and OnTrac only)."
},
"dept_number": {
"type": "object",
"description": "Specify the department number field on the label (FedEx and UPS only)."
},
"dry_ice": {
"type": "object",
"description": "Specify that the package contains Dry Ice (FedEx, Veho, and UPS only)."
},
"fda_product_code": {
"description": "Fda Product Code"
},
"fulfillment_center": {
"type": "string",
"description": "The fulfilment center where the package originates from."
},
"insurance": {
"type": "object",
"description": "To add 3rd party insurance powered by <a href=\"https://docs.goshippo.com/docs/shipments/shippinginsurance/\">XCover</a>, specify <br> `amount`, `content`, and `currency`. <br> Alternatively, you can choose carrier provided insurance by additionally specifying `provider` (UPS, FedEx and OnTrac only). <br><br> If you do not want to add insurance to your shipment, do not set these parameters."
},
"invoice_number": {
"type": "object",
"description": "Specify the invoice number field on the label (FedEx and UPS only)."
},
"is_return": {
"type": "boolean",
"description": "This field specifies if it is a scan-based return shipment. See the <a href=\"https://docs.goshippo.com/docs/shipments/returns/\">Create a return shipment</a> section for more details."
},
"lasership_attrs": {
"type": "array",
"description": "Specify Lasership Attributes (Lasership only). Multiple options accepted."
},
"lasership_declared_value": {
"type": "string",
"description": "Declared value (Lasership only). Defaults to `50.00`."
},
"manifest_number": {
"description": "Manifest Number"
},
"model_number": {
"description": "Model Number"
},
"part_number": {
"description": "Part Number"
},
"po_number": {
"type": "object",
"description": "Specify the PO number field on the label (FedEx and UPS only)."
},
"preferred_delivery_timeframe": {
"description": "Required for DHL Germany Paket Sameday. Designates a desired timeframe for delivery. Format is `HHMMHHMM`"
},
"premium": {
"type": "boolean",
"description": "Add premium service to a shipment (DHL Germany international shipments only)."
},
"production_code": {
"description": "Production Code"
},
"purchase_request_number": {
"description": "Purchase Request Number"
},
"qr_code_requested": {
"type": "boolean",
"description": "Request a QR code for a given transaction when creating a shipping label (USPS domestic and Evri UK only)."
},
"reference_1": {
"type": "string",
"description": "Optional text to be printed on the shipping label if supported by carrier. Up to 50 characters. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Max 40 characters (Express services); Max 30 characters (Ground services) |"
},
"reference_2": {
"type": "string",
"description": "Optional text to be printed on the shipping label if supported by carrier. Up to 50 characters. For DHL eCommerce, this field can be used for billing reference. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Max 30 characters |"
},
"request_retail_rates": {
"type": "boolean",
"description": "Returns retail rates instead of account-based rates (UPS and FedEx only)."
},
"return_service_type": {
"type": "string",
"description": "Request additional return option for return shipments (UPS and Lasership only)."
},
"rma_number": {
"type": "object",
"description": "Specify the RMA number field on the label (FedEx and UPS only)."
},
"saturday_delivery": {
"type": "boolean",
"description": "Marks shipment as to be delivered on a Saturday."
},
"salesperson_number": {
"description": "Salesperson Number"
},
"serial_number": {
"description": "Serial Number"
},
"signature_confirmation": {
"description": "Request standard or adult signature confirmation. You can alternatively request Certified Mail (USPS only) or Indirect signature (FedEx only) or Carrier Confirmation (Deutsche Post only)."
},
"store_number": {
"description": "Store Number"
},
"transaction_reference_number": {
"description": "Transaction Reference Number"
},
"usmca_eligible": {
"type": "boolean",
"description": "UPS only. Request USMCA (United States-Mexico-Canada Agreement) preferential tariff treatment. When enabled, it includes the USMCA eligibility declaration in customs documentation. Supported routes and value limits: - USA/Canada → Mexico: ≤ $1,000 USD - Canada/Mexico → USA: ≤ $2,500 USD - USA/Mexico → Canada: ≤ $3,300 CAD Only for declaration-only shipments, full USMCA - FormType 04 (Certificate of Origin) is not supported."
}
}
},
"metadata": {
"type": "string",
"description": "A string of up to 100 characters that can be filled with any additional information you want to attach to the object."
},
"parcels": {
"type": "array",
"description": "List of parcels to be shipped. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Max 30 items |"
},
"shipment_date": {
"type": "string",
"description": "Date the shipment will be tendered to the carrier. Must be in the format `2014-01-18T00:35:03.463Z`. Defaults to current date and time if no value is provided. Please note that some carriers require this value to be in the future, on a working day, or similar."
}
},
"required": [
"PCID",
"address_from",
"address_to",
"parcels"
]
}