Motorcycles

Create a listing to ship a Motorcycle or Moped in the Motorcycles & Power Sports category of the uShip marketplace.

 

POST

https://api.uship.com/v2/listings 

Sample Request Body


Required: Update the dates in this example so that they are at least one day ahead of the present date.

{
    "title": "Required (Motorcycle Listing) Title",
    "description": "Provide optional details about the motorcycle listing.",
    "route": {
        "items": [
            {
                "address": {
                    "streetAddress": "10155 Montague St",
                    "alternateStreetAddress": "Building 200, Suite 100",
                    "majorMunicipality": "Tampa",
                    "postalCode": "33626",
                    "stateProvince": "FL",
                    "country": "US",
                    "latitude": 28.056858,
                    "longitude": -82.605871,
                    "type": "Residence",
                    "timeZone": "America/New_York" 
                },
                "timeFrame": {
                    "earliestArrival": "2014/10/10",
                    "latestArrival": "2014/10/30",
                    "timeFrameType": "between"
                }
            },
            {
                "address": {
                    "streetAddress": "1234 Linton Drive",
                    "majorMunicipality": "Acworth",
                    "postalCode": "30102",
                    "stateProvince": "GA",
                    "country": "US",
                    "latitude": 34.097324,
                    "longitude": -84.614194,
                    "type": "BusinessWithLoadingDockOrForklift"
                },
                "timeFrame": {
                    "latestArrival": "2014/11/12",
                    "timeFrameType": "before"               
                }
            }
        ]
    },
    "pricing": {
        "namedPrice": {
            "amount": 300,
            "currencyType": "USD"
        }
    },
    "items": [
        {
            "Commodity": "MotorcyclesMopeds",
            "Title": "Item title",
            "Description": "Details about the motorcycle 1. 150cc Three Wheels Scooter",
            "Year": 2008,
            "MakeName": "Liang Zi Power",
            "ModelName": "TC_150_TKB",
            "IsRunning": true,
            "weightInGrams": 149685,
            "lengthInMeters": 2.045,
            "heightInMeters": 1.13,
            "wheelbaseInMeters": 1.5494,
            "groundClearanceInMeters": 0.14986,
            "widthInMeters": 0.72,
            "hasSidecar": false,
            "isPalletized": false,
            "isTrike": false
        },
        {
            "Commodity": "MotorcyclesMopeds",
            "Title": "Item title 2",
            "Description": "Details about the motorcycle 2.",
            "Year": 2008,
            "MakeName": "Suzuki",
            "ModelName": "GSX-R1000",
            "IsRunning": true,
            "weightInGrams": 171912,
            "lengthInMeters": 2.045,
            "heightInMeters": 1.13,
            "wheelbaseInMeters": 1.415,
            "groundClearanceInMeters": 0.12,
            "widthInMeters": 0.72,
            "hasSidecar": true,
            "isPalletized": false,
            "isTrike": false
        }
    ],
    "serviceTypes": [
            "OpenTransport", 
            "EnclosedTransport", 
            "LtlTransportOnly"
    ]
}

Response

Success Status: 201 Created

Response Header

Location header: https://api.uship.com/v2/listings/123456789 where 123456789 is an example of a {listingId} used in https://api.uship.com/v2/listings/{listingId}.

 

API Reference


Listing Object

Field Type Description Valid Sample Values
title
String Required. Brief descriptive name of the listing. "Lone Star Chic Bought Bike from LA"
description
String Longer explanation of the listing. "Just bought my first motorcycle from a private owner in LA. Need it to be safely transported to me in Texas."
serviceTypes
Array The service types requested for this listing. Retrieve a list of available service types for motorcycles via GET https://api.uship.com/v2/lookups/serviceTypes/. In the service types lookup, use commodityCode MotorcyclesPowerSports as the parameter value. See Service Types table below. "OpenTransport" "EnclosedTransport" "LtlTransportOnly"

 

Commodity Object

Field (bold if required) Type Description
items
Array List of motorcycle objects.
commodity
String Where the listing will be categorized under "Find Shipments" for Service Providers to bid on or book. See Commodities Lookups for the most current list. Use "MotorcyclesPowerSports" to create motorcycle listings.
title
String Required. Brief descriptive title of the listing item.
description
String Longer explanation of the listing item.
year
Integer The year the motorcycle was made.
modelName
String The motorcycle's model name. The make and model should match.
makeName
String The motorcycle's manufacturer.
isRunning
Boolean
  • true - Yes, the vehicle is running or can be driven and in working order.
  • false - No, the vehicle is not running and cannot be driven or moved on its own.
weightInGrams
Decimal The total weight of the motorcycle in grams.
lengthInmeters
Decimal The length of the motorcycle in meters.
heightInMeters
Decimal The height of the motorcycle in meters.
wheelbaseInMeters
Decimal The length of the wheelbase in meters.  The wheelbase is the distance between the centers of the front and rear wheels.
groundClearanceInMeters
Decimal The length of the ground clearance in meters. This is also called "ride height" or just "clearance" and is the distance between the base of  the tire and the underside of the chassis.
widthInMeters
Decimal The width of the motorcycle in meters.
hasSidecar
Boolean

Typically applies to motorcycle only.

  • true - Yes, the motorcycle has an attached sidecar.
  • false - No, the motorcycle does not have a sidecar.
isPalletized
Boolean
  • true - Yes, the item is on a wooden or plastic pallet and can be moved by forklift.
  • false - No, the item is not on a pallet.
isTrike
Boolean
  • true - Yes, the motorcycle has three wheels.
  • false - No, the motorcycle is not a three-wheel bike.

Pricing Object

Specify pricing with a named price. If the listing goes through auction, do not include this object.

Field Type Description Valid Sample Values
namedPrice
Container Wrapper for the pricing fields. -
amount
integer How much will this motorcycle / these motorcycles be listed to ship? 500
currencyType
Array The type indicated by the code that corresponds to the country and currency name. Currency Lookups has the most current list. "USD"

Route Origin or Destination Address Object

See Route Object reference.

Commodity Lookup Excerpt


This excerpt is from the GET https://api.uship.com/v2/lookups/commodities for motorcycles.

{
        "value": "MotorcyclesPowerSports",
        "label": "Motorcycles & Power Sports",
        "subCommodities": [{
            "value": "MotorcyclesMopeds",
            "label": "Motorcycles & Mopeds"
        }, {
            "value": "AllTerrainVehicles",
            "label": "All Terrain Vehicles"
        }, {
            "value": "GoCartsDuneBuggies",
            "label": "Go Carts & Dune Buggies"
        }, {
            "value": "Snowmobiles",
            "label": "Snowmobiles"
        }, {
            "value": "OtherPowerSports",
            "label": "Other Power Sports"
        }]
    },

 

Reference Enumerations


Address Types

Address Type Value Localized Label (EN-US)
Residence Residence
BusinessWithLoadingDockOrForklift Business (with loading dock or forklift)
BusinessWithoutLoadingDockOrForklift Business (without loading dock or forklift)
Port Port
ConstructionSite Construction Site
TradeShowOrConvention Trade Show / Convention Center
StorageFacility Storage Facility
MilitaryBase Military Base
Airport Airport
OtherSecuredLocation Other Secured or Limited Access Location

Service Types

Service Type Value Description
Open Transport Service "OpenTransport"  This service offering is the standard level of care for motorcyle transport. The Service Provider will carefully load the motorcycle onto an open trailer and secure it for transport. Some Service Providers even have customized trailers with padding and rigging designed exclusively for motorcycle transport. The Service Provider will tow the trailer to the delivery location and unload the motorcycle.
Enclosed Transport Service "EnclosedTransport"

This service offering is a premium level of care for motorcycle transport. The Service Provider will carefully load the motorcycle into an enclosed trailer that is protected from the elements and road debris.  Some Service Providers even have customized trailers with padding and rigging designed exclusively for motorcycle transport. The Service Provider will tow the trailer to the delivery location and unload the motorcycle. The premium service is commonly used for rare or high-value motorcycles or for transport through extreme climates.

LTL Freight and Packaging Service "FreightCurbsidePickup" The Service Provider picks up and packs items to freight standards, loads, and unloads items. Extra fees may apply for pick up and delivery inside.
LTL Standard  Freight Transport Only Service "LTL Transport Only" The Shipping Customer must pack items to freight standards, load, and unload items. Typically used by businesses with loading docks. Residential service and pick up or delivery inside may be available for extra fees.
Other "Other"

Example


Here is an example of how to create a motorcycle or moped listing on uship.com.

Create a Motorcycle Listing in the uShip Marketplace