Search
K
Stage - Listings API V2

DraftStopRequest

object

Details of a stop on a draft listing.

stopIdstring(uuid)

The system assigned UUID of the stop. Read-only on create (POST). Required on update (PUT).

stopNumberinteger(int32)

The sequential number of the stop along the route e.g. 1 is the pick up stop and 2 is the delivery stop.

Example:1

locationNamestring

The name of the stop.

<= 200 characters

Example:ABC Cars lot

addressstring

The street address.

<= 100 characters

Example:345 W Elm St.

address2string

Additional street address line.

<= 100 characters

Example:2nd Floor

citystring

The city.

<= 50 characters

Example:Anaheim

statestring

The state.

Example:CA

postalCodestring

The ZIP code. Must be a valid United States ZIP code or Canadian postal code.

<= 20 characters

Example:92802

countrystring

The country code. US or CA.

<= 2 characters

Example:US

phonestring

The primary phone number of the contact.

<= 50 characters

Example:949-555-1323

phone2string

An additional phone number of the contact.

<= 50 characters

Example:949-555-2434

phone3string

An additional phone number of the contact.

<= 50 characters

Example:949-555-3545

siteIdstring

The ID of the site.

Example:ABC

contactNamestring

The name of the contact.

<= 100 characters

Example:Mickey Smith

contactPhonestring

The primary phone number of the contact.

<= 50 characters

Example:949-555-1323

contactCellPhonestring

The cell phone number of the contact.

<= 50 characters

Example:949-555-1212

buyerNumberstring

The buyer reference number.

<= 70 characters

Example:12345

metroAreastring

The metro area of the stop.

<= 150 characters

Example:Orange County

twicboolean

Indicates whether the stop requires driver to have a Transportation Worker Identification Credential (TWIC). A TWIC is a credential required by the Maritime Transportation Security Act for carriers to access some locations. If you are not sure if a TWIC is needed, please contact the location.

Default:false

Example:true

geoCodeobject

Details of the geographic coordinates of a stop on a draft listing.

Show Child Parameters
locationTypestring

The facility type of the stop. This list is not exhaustive and additional values may be added at any time.

Allowed values:UnspecifiedAirportRentalCenterAuctionAuctionSatelliteLotCommercialBusinessCorporateOfficePlantCrossDockSatelliteStagingLotDealershipImpoundMarshallingYardMilitaryBaseMobileAuctionPortRailYardReconFacilityRentalCarRetailSiteRepoResidenceServiceCenterConsumerMovesTerminalOtherMechanicShopWarehouseParkingLot

Default:Unspecified

Example:Dealership

contactEmailAddressstring

The email address of the contact. Must be a valid email address format.

Example:mickey@snoogle.com

Example

DraftStopResponse

object

Details of a stop on a draft listing.

stopIdstring(uuid)

The system assigned UUID of the stop.

Example:4e2efc84-6add-435c-9f12-8b19e3e5ba21

stopNumberinteger(int32)

The sequential number of the stop along the route e.g. 1 is the pick up stop and 2 is the delivery stop.

Example:1

locationNamestring

The name of the stop.

Example:ABC Cars lot

addressstring

The street address.

Example:345 W Elm St.

address2string

Additional street address line.

Example:2nd Floor

citystring

The city.

Example:Anaheim

statestring

The state.

Example:CA

postalCodestring

The ZIP code. Must be a valid United States ZIP code or Canadian postal code.

Example:92802

countrystring

The country code. US or CA.

Example:US

distanceToNextStopInMilesinteger(int32)

The distance to the next stop in miles.

Example:267

phonestring

The primary phone number of the contact.

Example:949-555-1323

phone2string

An additional phone number of the contact.

Example:949-555-2434

phone3string

An additional phone number of the contact.

Example:949-555-3545

siteIdstring

The ID of the site.

Example:ABC

contactNamestring

The name of the contact.

Example:Mickey Smith

contactPhonestring

The primary phone number of the contact.

Example:949-555-1323

contactCellPhonestring

The cell phone number of the contact.

Example:949-555-1212

contactEmailAddressstring

The email address of the contact. Must be a valid email address format.

Example:mickey@snoogle.com

metroAreastring

The metro area of the stop.

Example:Orange County

locationTypestring

The facility type of the stop. This list is not exhaustive and additional values may be added at any time.

Allowed values:UnspecifiedAirportRentalCenterAuctionAuctionSatelliteLotCommercialBusinessCorporateOfficePlantCrossDockSatelliteStagingLotDealershipImpoundMarshallingYardMilitaryBaseMobileAuctionPortRailYardReconFacilityRentalCarRetailSiteRepoResidenceServiceCenterConsumerMovesTerminalOtherMechanicShopWarehouseParkingLot

Example:Dealership

geoCodeobject

Details of the geographic coordinates of a stop on a draft listing.

Show Child Parameters
twicboolean

Indicates whether the stop requires driver to have a Transportation Worker Identification Credential (TWIC). A TWIC is a credential required by the Maritime Transportation Security Act for carriers to access some locations. If you are not sure if a TWIC is needed, please contact the location.

Example:true

buyerNumberstring

The buyer reference number.

Example:12345

Example

DraftVehicleRequest

object

Details of a vehicle on a draft listing.

vehicleIdstring(uuid)

The system assigned UUID of the vehicle.

  • POST (Create): Read-only. Do not include a client-supplied value — the system generates this on creation.
  • PUT (Update): Required only if you are updating an existing vehicle — supply the vehicleId of the vehicle you intend to update. Omit it to add a new vehicle to the listing.

⚠️ Important: If vehicleId is omitted on a PUT request for a vehicle you intended to update, the system cannot match the request to an existing vehicle and will treat it as a new vehicle creation. This will count against your vehicle quota.

externalVehicleIdstring

A vehicle identifier managed by the user. Shippers can use this field to map a vehicle record in their local TMS to a Central Dispatch record.

<= 50 characters

Example:EXT123456

pickupStopNumberinteger(int32)

The stop number where the vehicle will be picked up.

Example:1

dropoffStopNumberinteger(int32)

The sequential stop number where the vehicle will be delivered. Must be greater than pickupStopNumber.

Example:2

vinstring

The vehicle identification number (VIN). Required if year, make and model are null.

<= 50 characters

Example:KL8CH6SA6NC001234

yearinteger(int32)

The 4 digit year of the vehicle. Required if vin is null.

Example:2022

makestring

The manufacturer’s make of the vehicle. Required if vin is null.

<= 50 characters

Example:Chevrolet

modelstring

The manufacturer’s model of the vehicle. Required if vin is null.

<= 50 characters

Example:Spark

trimstring

The manufacturer’s trim of the vehicle.

<= 100 characters

Example:LS

vehicleTypestring

The type of vehicle e.g. CAR, PICKUP, SUV. This list is not exhaustive and additional values may be added at any time.

Allowed values:ATVBOATCARHEAVY_EQUIPMENTLARGE_YACHTMOTORCYCLEOTHERPICKUPRVSUVTRAVEL_TRAILERVAN

Default:OTHER

Example:CAR

vehicleTypeOtherstring

The description of the vehicle type. Will default to Other when null and vehicleType is OTHER.

<= 100 characters

Example:Golf Cart

colorstring

The color of the vehicle.

<= 100 characters

Example:Red

licensePlatestring

The license plate of the vehicle.

<= 20 characters

Example:B314PIE

licensePlateStatestring

The two-letter state abbreviation of the vehicle’s license plate.

<= 2 characters

Example:CA

lotNumberstring

The lot number of the vehicle.

<= 50 characters

Example:LOT789

isInoperableboolean

Indicates whether the vehicle is inoperable.

Default:false

tariffnumber(double)

The tariff on the vehicle.

Example:1030.5

tariffCurrencystring

The currency of the monetary field. This list is not exhaustive and additional values may be added at any time.

Allowed values:USD

Default:USD

Example:USD

additionalInfostring

Additional information.

<= 500 characters

Example:The vehicle is in the back of the lot behind the big tree.

oversizedboolean

Indicates whether the load is oversized.

Default:false

shippingSpecsobject

Details of the shipping specifications of a vehicle.

Show Child Parameters
vehicleAttributesarray[object]

Details of a vehicle attribute.

Show Child Parameters
noKeysboolean

Indicates whether the vehicle has no keys.

Default:false

Example:true

noTiresboolean

Indicates whether the vehicle has no tires.

Default:false

flatTireboolean

Indicates whether the vehicle has a flat tire.

Default:false

Example:true

frameDamageboolean

Indicates whether the vehicle has frame damage.

Default:false

doesNotRunboolean

Indicates whether the vehicle does not run.

Default:false

Example:true

doesNotSteerboolean

Indicates whether the vehicle does not steer.

Default:false

doesNotRollboolean

Indicates whether the vehicle does not roll.

Default:false

inOpNotesstring

Notes about the inoperable condition of the vehicle.

<= 200 characters

Example:Vehicle does not start.

Example

DraftVehicleResponse

object

Details of a vehicle on a draft listing.

vehicleIdstring(uuid)

The ID of the vehicle.

Example:b331c130-e89b-12d3-a456-426614174000

externalVehicleIdstring

A vehicle identifier managed by the user. Shippers can use this field to map a vehicle record in their local TMS to a Central Dispatch record.

Example:EXT123456

pickupStopNumberinteger(int32)

The stop number where the vehicle will be picked up.

Example:1

dropOffStopNumberinteger(int32)

The sequential stop number where the vehicle will be delivered.

Example:2

vinstring

The vehicle identification number (VIN).

Example:KL8CH6SA6NC001234

yearinteger(int32)

The 4 digit year of the vehicle.

Example:2022

makestring

The manufacturer’s make of the vehicle.

Example:Chevrolet

modelstring

The manufacturer’s model of the vehicle.

Example:Spark

trimstring

The manufacturer’s trim of the vehicle.

Example:LS

vehicleTypestring

The type of vehicle e.g. CAR, PICKUP, SUV. This list is not exhaustive and additional values may be added at any time.

Allowed values:ATVBOATCARHEAVY_EQUIPMENTLARGE_YACHTMOTORCYCLEOTHERPICKUPRVSUVTRAVEL_TRAILERVAN

vehicleTypeOtherstring

The description of the vehicle type.

Example:CAR

colorstring

The color of the vehicle.

Example:Red

licensePlatestring

The license plate of the vehicle.

Example:B314PIE

licensePlateStatestring

The two-letter state abbreviation of the vehicle’s license plate.

Example:CA

lotNumberstring

The lot number of the vehicle.

Example:LOT789

isInoperableboolean

Indicates whether the vehicle is inoperable.

tariffnumber(double)

The tariff on the vehicle.

Example:1030.5

tariffCurrencystring

The currency of the monetary field. This list is not exhaustive and additional values may be added at any time.

Allowed values:USD

Default:USD

Example:USD

additionalInfostring

Additional information.

Example:The vehicle is in the back of the lot behind the big tree.

oversizedboolean

Indicates whether the load is oversized.

shippingSpecsobject

Details of the shipping specifications of a vehicle.

Show Child Parameters
vehicleAttributesarray[object]

Details of a vehicle attribute.

Show Child Parameters
noKeysboolean

Indicates whether the vehicle has no keys.

Example:true

noTiresboolean

Indicates whether the vehicle has no tires.

flatTireboolean

Indicates whether the vehicle has a flat tire.

Example:true

frameDamageboolean

Indicates whether the vehicle has frame damage.

doesNotRunboolean

Indicates whether the vehicle does not run.

Example:true

doesNotSteerboolean

Indicates whether the vehicle does not steer.

doesNotRollboolean

Indicates whether the vehicle does not roll.

inOpNotesstring

Notes about the inoperable condition of the vehicle.

Example:Vehicle does not start.

Example

Error

object

Details of an error or issue.

codestring

The code used for the issue.

Example:resource.issue_type

messagestring

A detailed message.

Example:The issue happened because something is wrong.

propertystring

The property to which the issue is associated.

Example:person

propertiesobject

Additional properties related to the issue.

Example:{"firstName":"D0nn@","lastName":"Sm!th"}

Example