Skip to main content

UpdateShipmentRequest

Request payload for creating a new shipment

customer object

information associated with the customer of the shipment

customer_nameCustomerName (string)required

Name of the customer, can be a dealership name, business name or a person's name"

Example: Basic Enterprise, LLC
customer_typeLocationType (string)

The type of business associated with the address

Possible values: [AUCTION, BUSINESS, DEALER, PRIVATE, REPO_YARD, PORT]

Example: DEALER
addressCustomerAddress (string)

The street address of the customer

Example: 123 Test Dr
cityCustomerCity (string)

The city for the customer address

Example: Dallas
stateCustomerState (string)

the state for the customer address

Example: TX
zipcodeCustomerZipcode (integer)

The zipcode for the customer address

Example: 75234
emailContactEmail (string)

Email address of the person to contact

Example: jsmith@domain.com
phoneContactPhone (string)

Phone number of the person to contact

Example: 2145550000
contact_nameContactName (string)

Name of the person to contact

Example: John Smith
contact_emailContactEmail (string)

Email address of the person to contact

Example: jsmith@domain.com
contact_phoneContactPhone (string)

Phone number of the person to contact

Example: 2145550000
pickup object

details of the delivery location

location_nameLocationName (string)

name of the location for the order pickup

Example: Pickup Here, LLC
location_typeLocationType (string)

The type of business associated with the address

Possible values: [AUCTION, BUSINESS, DEALER, PRIVATE, REPO_YARD, PORT]

Example: DEALER
addressPickupAddress (string)

The street address of the pickup location

Example: 123 Test Dr
cityPickupCity (string)

The city of the pickup location

Example: Dallas
statePickupState (string)

the state of the pickup location

Example: TX
zipcodePickupZipcode (integer)

The zipcode of the pickup location

Example: 75234
contact_nameContactName (string)

Name of the person to contact

Example: John Smith
contact_emailContactEmail (string)

Email address of the person to contact

Example: jsmith@domain.com
contact_phoneContactPhone (string)

Phone number of the person to contact

Example: 2145550000
notesPickupNotes (string)

Any notes or instructions related to the pickup

Example: Add any notes or instructions here
available_pickup_dttmDate

The date the shipment is available for pickup

Example: 2024-08-10T08:00:00-0500
scheduled_pickup_dttmdate

The scheduled pickup date

Example: 2024-08-10T08:00:00.000+0000
scheduled_pickup_dttm_enddatenullable

The end of the scheduled pickup date range

Example: 2024-08-10T08:00:00.000+0000
pickup_dttmDate

The date the shipment is available for pickup

Example: 2024-08-10T08:00:00-0500
delivery object

details of the delivery location

location_nameLocationName (string)

name of the location for the order pickup

Example: Pickup Here, LLC
location_typeLocationType (string)

The type of business associated with the address

Possible values: [AUCTION, BUSINESS, DEALER, PRIVATE, REPO_YARD, PORT]

Example: DEALER
addressDeliveryAddress (string)required

The street address of the delivery location

Example: 123 Test Dr
cityDeliveryCity (string)required

The city of the delivery location

Example: Dallas
stateDeliveryState (string)required

the state of the delivery location

Example: TX
zipcodeDeliveryZipcode (integer)required

The zipcode of the delivery location

Example: 75234
contact_nameContactName (string)required

Name of the person to contact

Example: John Smith
contact_emailContactEmail (string)required

Email address of the person to contact

Example: jsmith@domain.com
contact_phoneContactPhone (string)required

Phone number of the person to contact

Example: 2145550000
notesDeliveryNotes (string)

Any notes or instructions related to the delivery

Example: Add any notes or instructions here
preferred_delivery_dttmDate

The date you would like the shipment to be delivered

Example: 2024-08-18T08:00:00-0500
scheduled_delivery_dttmDate

The date you would like the shipment to be delivered

Example: 2024-08-18T08:00:00-0500
scheduled_delivery_dttm_endDate

The date you would like the shipment to be delivered

Example: 2024-08-18T08:00:00-0500
delivery_dttmDate

The date you would like the shipment to be delivered

Example: 2024-08-18T08:00:00-0500
vehicles object[]

An array of vehicle objects included in this shipment

  • Array [
    • vinstringrequired

    Vehicle Identification Number

    Example: 1G8AL52F03Z157046
    yearinteger

    Production year of the vehicle

    Example: 2020
    makestring

    Manufacturer of the vehicle

    Example: Dodge
    modelstring

    The model of the vehicle produced bt the manufacturer

    Example: RAM ProMaster
    trimstring

    The specific trim level of this vehicle model

    Example: Cargo Van
    typeVehicleType (string)

    The type of vehicle for this shipment

    Possible values: [car, suv, van, truck, truck_ext, work_van, service_body]

    Example: van
    is_modifiedboolean

    A flag determining if the vehicle has modifications

    Example: false
    is_inoperableboolean

    A flag determining if the vehicle is in operable

    Example: false
    notesstring

    Notes about any modifications, issues or warnings about the vehicle

    Example: Vehicle is rusting underneath
  • ]
    • transport_typeTransportType (string)

    The type of transportation needed for this shipment

    Possible values: [open, enclosed]

    Example: enclosed
    instructionsShipmentInstructions (string)

    Instructions for this shipment

    Example: Specify any instructions specific to this shipment
    external_idstring

    An external identifier for your own records

    Example: unique_id
    UpdateShipmentRequest
    {
      "customer": {
        "customer_name": "Basic Enterprise, LLC",
        "customer_type": "DEALER",
        "address": "123 Test Dr",
        "city": "Dallas",
        "state": "TX",
        "zipcode": 75234,
        "email": "jsmith@domain.com",
        "phone": "2145550000",
        "contact_name": "John Smith",
        "contact_email": "jsmith@domain.com",
        "contact_phone": "2145550000"
      },
      "pickup": {
        "location_name": "Pickup Here, LLC",
        "location_type": "DEALER",
        "address": "123 Test Dr",
        "city": "Dallas",
        "state": "TX",
        "zipcode": 75234,
        "contact_name": "John Smith",
        "contact_email": "jsmith@domain.com",
        "contact_phone": "2145550000",
        "notes": "Add any notes or instructions here",
        "available_pickup_dttm": "2024-08-10T08:00:00-0500",
        "scheduled_pickup_dttm": "2024-08-10T08:00:00.000+0000",
        "scheduled_pickup_dttm_end": "2024-08-10T08:00:00.000+0000",
        "pickup_dttm": "2024-08-10T08:00:00-0500"
      },
      "delivery": {
        "location_name": "Pickup Here, LLC",
        "location_type": "DEALER",
        "address": "123 Test Dr",
        "city": "Dallas",
        "state": "TX",
        "zipcode": 75234,
        "contact_name": "John Smith",
        "contact_email": "jsmith@domain.com",
        "contact_phone": "2145550000",
        "notes": "Add any notes or instructions here",
        "preferred_delivery_dttm": "2024-08-18T08:00:00-0500",
        "scheduled_delivery_dttm": "2024-08-18T08:00:00-0500",
        "scheduled_delivery_dttm_end": "2024-08-18T08:00:00-0500",
        "delivery_dttm": "2024-08-18T08:00:00-0500"
      },
      "vehicles": [
        {
          "vin": "1G8AL52F03Z157046",
          "year": 2020,
          "make": "Dodge",
          "model": "RAM ProMaster",
          "trim": "Cargo Van",
          "type": "van",
          "is_modified": false,
          "is_inoperable": false,
          "notes": "Vehicle is rusting underneath"
        }
      ],
      "transport_type": "enclosed",
      "instructions": "Specify any instructions specific to this shipment",
      "external_id": "unique_id"
    }