PUT Pickup?Location={Location}&Address={Address}&Zip={Zip}&Bills={Bills}&Units={Units}&Weight={Weight}&TestFlag={TestFlag}
Submit a simple pickup request using query string parameters
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
Location |
Location name |
string |
Required |
Address |
Location address |
string |
Required |
Zip |
Zip or postal code |
string |
Required |
Bills |
Total number of freight bills that will be picked up |
integer |
Required |
Units |
Total number of handling units that will be picked up |
integer |
Required |
Weight |
Total weight in pounds that will be picked up |
decimal number |
Required |
TestFlag |
Set to true if you this is a test |
boolean |
None. |
Body Parameters
None.
Response Information
Resource Description
PickupName | Description | Type | Additional information |
---|---|---|---|
FreightBillNum |
Pickup confirmation number |
string |
None. |
Message |
Informational message displaying errors, conflicts, and service notices |
string |
None. |
PickupSchedule |
Date/time window when the freight will be available for pickup |
Schedule |
Required |
PickupAddress |
Location where the freight should be picked up |
Address |
Required |
DeliveryAddress |
Location where the freight will be delivered |
Address |
None. |
TotalBills |
Total number of freight bills that will be picked up |
integer |
Required Range: inclusive between 1 and 500 |
TotalUnits |
Total number of handling units that will be picked up |
integer |
Required Range: inclusive between 1 and 500 |
TotalWeight |
Total weight in pounds that will be picked up |
decimal number |
Required Range: inclusive between 1 and 999999 |
Description |
General description of the freight to be picked up. Please review prohibited articles and restricted articles in the rules tariff. |
string |
None. |
HazmatTotals |
Total weight by hazard class of any hazardous material to be picked up. Please review prohibited articles and restricted articles in the rules tariff. |
Collection of PickupHazmat |
None. |
SpecialInstructions |
Any special instructions related to the pickup |
string |
None. |
EmailConfirmation |
If provided, an email confirmation will be sent to this email address. For multiple addresses, separate them with a semicolon (;). |
string |
Matching regular expression pattern: ^[\w\&\+\-\.]+@([\w\d-]+\.)+[\w]{2,}(\;|$)+$ |
TestFlag |
When true, the pickup will be cancelled immediately after being created, and a driver will not be dispatched. |
boolean |
None. |
Response Formats
application/json, text/json
{ "PickupSchedule": { "After": "2024-11-09T20:18:13.4235632-06:00", "Before": "2024-11-09T20:18:13.4235632-06:00", "AppointmentRequired": true, "AppointmentMade": true }, "PickupAddress": { "Name": "sample string 1", "Address1": "sample string 2", "Address2": "sample string 3", "City": "sample string 4", "State": "sample string 5", "Zip": "sample string 6", "Country": "sample string 7", "Contact": "sample string 8", "Phone": "sample string 9", "Latitude": 1.1, "Longitude": 1.1 }, "DeliveryAddress": { "Name": "sample string 1", "Address1": "sample string 2", "Address2": "sample string 3", "City": "sample string 4", "State": "sample string 5", "Zip": "sample string 6", "Country": "sample string 7", "Contact": "sample string 8", "Phone": "sample string 9", "Latitude": 1.1, "Longitude": 1.1 }, "TotalBills": 3, "TotalUnits": 4, "TotalWeight": 5.1, "Description": "sample string 6", "HazmatTotals": [ { "HazardClass": 1.1, "Weight": 2.1 }, { "HazardClass": 1.1, "Weight": 2.1 } ], "SpecialInstructions": "sample string 7", "EmailConfirmation": "sample string 8", "TestFlag": true, "FreightBillNum": "sample string 1", "Message": "sample string 2" }
application/xml, text/xml
<Pickup xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <PickupSchedule> <After>2024-11-09T20:18:13.4235632-06:00</After> <Before>2024-11-09T20:18:13.4235632-06:00</Before> <AppointmentRequired>true</AppointmentRequired> <AppointmentMade>true</AppointmentMade> </PickupSchedule> <PickupAddress> <Name>sample string 1</Name> <Address1>sample string 2</Address1> <Address2>sample string 3</Address2> <City>sample string 4</City> <State>sample string 5</State> <Zip>sample string 6</Zip> <Country>sample string 7</Country> <Contact>sample string 8</Contact> <Phone>sample string 9</Phone> <Latitude>1.1</Latitude> <Longitude>1.1</Longitude> </PickupAddress> <DeliveryAddress> <Name>sample string 1</Name> <Address1>sample string 2</Address1> <Address2>sample string 3</Address2> <City>sample string 4</City> <State>sample string 5</State> <Zip>sample string 6</Zip> <Country>sample string 7</Country> <Contact>sample string 8</Contact> <Phone>sample string 9</Phone> <Latitude>1.1</Latitude> <Longitude>1.1</Longitude> </DeliveryAddress> <TotalBills>3</TotalBills> <TotalUnits>4</TotalUnits> <TotalWeight>5.1</TotalWeight> <Description>sample string 6</Description> <HazmatTotals> <PickupHazmat> <HazardClass>1.1</HazardClass> <Weight>2.1</Weight> </PickupHazmat> <PickupHazmat> <HazardClass>1.1</HazardClass> <Weight>2.1</Weight> </PickupHazmat> </HazmatTotals> <SpecialInstructions>sample string 7</SpecialInstructions> <EmailConfirmation>sample string 8</EmailConfirmation> <TestFlag>true</TestFlag> <FreightBillNum>sample string 1</FreightBillNum> <Message>sample string 2</Message> </Pickup>