## International Orders

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.

### Country Code

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:

| Destination | `Country` value |
|  --- | --- |
| United States | `USA` |
| United Kingdom | `GBR` |
| Japan | `JPN` |
| Puerto Rico | `PRI` |
| Canada | `CAN` |
| South Korea | `KOR` |
| Hong Kong | `HKG` |
| Singapore | `SGP` |


For destinations not listed here, look up the 3-letter code in the [ISO 3166-1 alpha-3 reference](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) or contact [api@wineshipping.com](mailto:api@wineshipping.com) to confirm support.

### International Address Mapping

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

| Address component | API field | Notes |
|  --- | --- | --- |
| Building number + street | `Address` | e.g. `10 Downing Street` |
| Flat, floor, or suite | `Address2` | Optional |
| Town or city | `City` | e.g. `London` |
| State / Province | `State` | **Leave blank** for international addresses. This field accepts US/CA 2-letter codes only (`maxLength: 2`). |
| Postal / ZIP code | `ZipCode` | **Leave blank** for international addresses. This field is for US/CA postal codes only. |
| Country | `Country` | ISO 3166-1 alpha-3 code, e.g. `GBR` |
| Phone | `PhoneNumber` | Include the international dialling prefix, e.g. `+44 20 7925 0918` |


### Carrier and Service Codes

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

| Carrier | Service code | Description |
|  --- | --- | --- |
| `FEX` | `INPR` | FedEx International Priority |


For a full list of carrier and service codes, see [Carrier Codes](/docs/codes/carriercodes).

### Example - United Kingdom (Retail, FedEx International Priority)

See the **International — United Kingdom** example in the [CreateSalesOrder](/api/v3.1/openapi/fulfillment/createsalesorder) endpoint for a full request body.

Key fields at a glance:

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