ShippingDetails

The ShippingDetails shared object definition, reused across multiple Global-e API endpoints.

ShippingDetails is a shared, cross-endpoint object definition. An individual endpoint uses only the subset its own request or response references — always check that endpoint’s reference page for the fields it actually accepts or returns.

Field	Type	Required	Description
Address1	String	—	Address line 1. Unlimited length.
Address2	String	—	Address line 2. Unlimited length.
City	String	—	City name. Max length: 500 chars.
CountryCode	String	—	2-char ISO country code
CountryName	String	—	Country name. Max length: 255 chars.
Email	String	—	E-mail address. Max length: 500 chars.
Fax	String	—	Fax number. Max length: 250 chars.
FirstName	String	—	First name. Max length: 40 chars. No length validation. The rest will be truncated.
LastName	String	—	Last name. Max length:40 chars. No length validation. The rest will be truncated.
MiddleName	String	—	Middle name. Max length:40 chars. No length validation. The rest will be truncated.
Phone1	String	—	Phone #1. Max length: 250 chars.
Phone2	String	—	Phone #2. Max length: 250 chars.
Salutation	String	—	Salutation or title (e.g. Dr., Mr., etc.). Max length: 500 chars.
StateCode	String	—	State or province ISO code such as AZ for Arizona (if applicable). 2 chars.
StateOrProvince	String	—	State or province name. Max length: 500 chars.
UserId	Decimal	—	Internal User identifier on the Merchant site
UserIdNumber	String	—	User’s personal ID document number
UserIdNumberType	String	—	User’s personal ID document type (e.g. Passport, ID card, etc.)
Zip	String	—	Zip or postal code. Max length: 250 chars.