The Wineshipping API supports international shipments via select carriers and services. This guide covers how to map international address fields — particularly for United Kingdom addresses — to the BillingContactInfo, RecipientContactInfo, and DeliveryContactInfo request objects.

All contact address blocks accept an ISO 3166-1 alpha-3 (3-letter) country code in the Country field.

The most commonly used international country codes are listed below, ranked by order volume:

For destinations not listed here, look up the 3-letter code in the ISO 3166-1 alpha-3 reference or contact api@wineshipping.com to confirm support.

For all international (non-US/CA) addresses, State and ZipCode must be left blank. Use the table below as a guide.

International shipments require a carrier and service that supports the destination country. Contact Wineshipping to confirm which combinations are enabled for your account.

For a full list of carrier and service codes, see Carrier Codes.

See the International — United Kingdom example in the CreateSalesOrder endpoint for a full request body.

Key fields at a glance:

{
  "BillingContactInfo": {
    "City": "London",
    "State": "",
    "ZipCode": "",
    "Country": "GBR"
  },
  "ShipmentInfo": {
    "ShippingCarrier": "FEX",
    "ShippingCarrierService": "INPR"
  }
}