This instance couldn't reach its API specification on the last attempt, so this page shows the copy fetched before that. Anything added or changed since then is missing here, and the reference updates itself as soon as the specification is readable again. Last fetched 2026-10-23 00:19 UTC.
A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.
Input for creating a ship-from origin.
Values
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Fields
Field
Type
Description
merchantIdrequired
string (uuid)
The merchant that owns this origin. Required on create, and immutable afterwards: an update
that names a different merchant is refused rather than silently moving the origin.nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
namerequired
string
Operator-facing name of the location, for example "Main warehouse".nullablemax length 128
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
The ship-from address. Required: an origin with no address is not somewhere a parcel can ship
from. US addresses carry State and Zip; every other country carries Province and Postal Code.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Fields of Address:
Field
Type
Description
idrequired
string (uuid)
Gets the unique identifier for the address.read only
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
address1required
string
Gets or sets the first line of the address (e.g., street address).nullablemax length 100
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
address2required
string
Gets or sets the second line of the address (e.g., apartment, suite, unit, building, floor, etc.).nullablemax length 100
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
cityrequired
string
Gets or sets the city of the address.nullablemax length 100
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
staterequired
string
Gets or sets the state or region of the address.nullablemax length 100
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
provincerequired
string
Gets or sets the province of the address (if applicable).nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
ziprequired
string
Gets or sets the ZIP code of the address.
Conditional: Conditional (see validator source). Pattern: ^\d{5}(-\d{4})?$.
Conditional: When IsUsCountry(Country) is false. Max length: 20.nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
postalCoderequired
string
Gets or sets the postal code of the address.nullablemax length 20
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
countryrequired
string
Gets or sets the country of the address. Defaults to "USA".nullablemax length 100
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
isMailingrequired
boolean
Gets or sets a value indicating whether this address is a mailing address.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
isDefaultrequired
boolean
Gets or sets a value indicating whether this address is the default address.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
This body has no documented fields.
phonerequired
string
An optional contact number for the location, which some carriers ask for when quoting.nullablemax length 32
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
isDefaultrequired
boolean
Whether this is the merchant's default origin. A merchant's first origin is the default
whatever this says; setting it on another origin moves the flag there. It cannot be switched
off on the current default while the merchant has other origins.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
This model has no documented fields.
Reconnecting to the server
Could not reconnect
This session has ended
Attempt 1
Your work on this page is still here. Retrying keeps it; reloading starts the page again.
The server no longer holds this page's state, so it has to be loaded again.