Skip to main content

A type that defines the fields for a shipping address. For restrictions, see Shipping restrictions.

Note: If the address cannot be validated, a warning message will be returned.

Types that use ShippingAddress

CreateGuestCheckoutSessionRequestV2GuestCheckoutSessionResponseV2

Calls that use ShippingAddress

POST
/guest_checkout_session/{checkoutSessionId}/apply_coupon
GET
/guest_checkout_session/{checkoutSessionId}
POST
/guest_checkout_session/initiate
POST
/guest_checkout_session/{checkoutSessionId}/remove_coupon
POST
/guest_checkout_session/{checkoutSessionId}/update_quantity
POST
/guest_checkout_session/{checkoutSessionId}/update_shipping_address
POST
/guest_checkout_session/{checkoutSessionId}/update_shipping_option

Fields

Field
Type
Description
addressLine1
string
The first line of the street address where the item is being shipped.

Maximum:
  • 40 characters for AU, CA, and US marketplaces
  • 35 characters for DE and GB marketplaces
  • 50 characters for all other marketplaces
addressLine2
string
The second line of the street address where the item is being shipped. This optional field can be used for information such as 'Suite Number' or 'Apt Number'.

Maximum:
  • 40 characters for AU, CA, and US marketplaces
  • 35 characters for DE and GB marketplaces
  • 50 characters for all other marketplaces
city
string
The city of the address where the item is being shipped.
country
CountryCodeEnum
The two letter code representing the country of the address.
county
string
The county of the address where the item is being shipped.
phoneNumber
string
The phone number of the person receiving the package.

Note: It is highly recommended that when entering the phone number you include the country code.

For example, if a US phone number is 4********4, you would enter +14********4. If you do not include this code, the service will use the country specified in the country field.

You can find the country code at https://countrycode.org.
postalCode
string
The postal code of the address where the item is being shipped.

Note: This is optional when shipping to EBAY_HK (Hong Kong).
recipient
Recipient
The name of the person receiving the package.
stateOrProvince
string
The state or province of the address.

Note: For the US marketplace, this is a two-character value. For a list of valid values, see US State and Canada Province Codes.