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

Fields

Field
Type
Description
addressLine1
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
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
The city of the address where the item is being shipped.
country
The two letter code representing the country of the address.
county
The county of the address where the item is being shipped.
phoneNumber
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
The postal code of the address where the item is being shipped.

Note: This is optional when shipping to EBAY_HK (Hong Kong).
recipient
The name of the person receiving the package.
stateOrProvince
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.

Got thoughts? Click the feedback button – your insights help us improve!