International Shipping

Ship internationally with customs declarations, HS codes, and duty/tax calculation.

Creating an international shipment

International shipments require a customs declaration with item details:

curl -X POST https://api.flexops.io/v1/labels \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "carrier": "dhl",
    "service": "express_worldwide",
    "from": {
      "name": "FlexOps HQ",
      "street1": "123 Main St",
      "city": "Denver",
      "state": "CO",
      "zip": "80202",
      "country": "US"
    },
    "to": {
      "name": "Hans Mueller",
      "street1": "Friedrichstr. 123",
      "city": "Berlin",
      "zip": "10117",
      "country": "DE"
    },
    "parcel": { "weightOz": 32, "lengthIn": 12, "widthIn": 8, "heightIn": 6 },
    "customs": {
      "contentsType": "merchandise",
      "items": [
        {
          "description": "Cotton T-Shirt",
          "quantity": 2,
          "value": 25.00,
          "currency": "USD",
          "weightOz": 8,
          "hsCode": "6109.10",
          "originCountry": "US"
        }
      ],
      "incoterm": "DDU"
    }
  }'

Incoterms

Code	Description	Who pays duties
DDU	Delivered Duty Unpaid	Recipient
DDP	Delivered Duty Paid	Sender

HS Codes

Harmonized System (HS) codes classify goods for customs. If you don't know the HS code, omit it and the carrier will attempt classification (may cause delays).

Supported international carriers

Carrier	Best for
DHL Express	Fastest international, 220+ countries
FedEx International	US ↔ major markets
UPS Worldwide	Heavy freight, reliable tracking
Canada Post	US ↔ Canada
Royal Mail	US ↔ UK
Australia Post	US ↔ Australia/NZ