> For the complete documentation index, see [llms.txt](https://docs.whitearrow.com/white-arrow-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whitearrow.com/white-arrow-api-documentation/new-tender.md).

# New Tender

**POST v2/quotes/tender**

The tender endpoint is used to tender White Arrow loads from a quote generated by the user.

***

## Request

## Tender Object

<table data-full-width="true"><thead><tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td>quoteNumber</td><td>string</td><td>Yes</td><td>Quote number is the id from the quote response service level that you wish to tender. Ex. P12345 or G12345 or E12345</td></tr><tr><td>referenceNumber</td><td>string</td><td>Yes</td><td>The quoting party's <strong>unique</strong> load identification number / BOL number / Pro number.</td></tr><tr><td>notes</td><td>string</td><td>No</td><td>Any relevant notes to be included with the load.</td></tr><tr><td>tenderStops</td><td>array</td><td>Yes</td><td>An array of tender stop objects. See Below.</td></tr><tr><td>tenderCommodities</td><td>array</td><td>Conditional</td><td>An array of tender commodity objects. See Below. Only required if there is more than one pickup or more than one delivery</td></tr></tbody></table>

## Tender Stop Object

<table data-full-width="true"><thead><tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td>shipConID</td><td>int</td><td>Yes</td><td>The id of the stop that was returned in the quote response.</td></tr><tr><td>name</td><td>string</td><td>Yes*</td><td>The name of the location of the stop. Ex. Acme Warehouse</td></tr><tr><td>line1</td><td>string</td><td>Yes*</td><td>The street address of the stop. Ex. 500 Citadel Dr.</td></tr><tr><td>city</td><td>string</td><td>Yes*</td><td>The city of the stop</td></tr><tr><td>state</td><td>string</td><td>Yes*</td><td>The state of the stop. Must be in two letter format i.e. 'CA'</td></tr><tr><td>zip</td><td>string</td><td>Yes*</td><td>The zip code of the stop.</td></tr><tr><td>referenceNumber</td><td>string</td><td>Yes</td><td>Any relevant reference number / BOL number / Pro Number for the stop.</td></tr><tr><td>confimationNumber</td><td>string</td><td>No</td><td>The confirmation number for the stop if any.</td></tr><tr><td>date</td><td>string</td><td>Yes</td><td><strong>Required for pickups only</strong>. The date of the stop in the form '2016-01-31' (YEAR-MONTH-DAY).</td></tr><tr><td>timeFrom</td><td>string</td><td>No</td><td>The earliest time of an appointment window for a stop in the form '14:00' <strong>ALL TIMES ARE THE LOCAL TIME OF THE STOP</strong>.</td></tr><tr><td>timeTo</td><td>string</td><td>No</td><td>The latest time of an appoinmtment window for a stop in the form '16:00' <strong>ALL TIMES ARE THE LOCAL TIME OF THE STOP</strong>.</td></tr><tr><td>contactName</td><td>string</td><td>No</td><td>Name of contact person at the stop location.</td></tr><tr><td>phone</td><td>string</td><td>No</td><td>Contact phone number for the stop location.</td></tr><tr><td>notes</td><td>string</td><td>No</td><td>Any notes for the stop.</td></tr></tbody></table>

\*The field is only required if the quote stop did not return a locationId

## Tender Commodity Object

<table data-full-width="true"><thead><tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td>shipperID</td><td>int</td><td>Yes</td><td>The id of the pickup for the commodity. The id comes from the stop that was returned in the quote response.</td></tr><tr><td>consigneeID</td><td>int</td><td>Yes</td><td>The id of the delivery for the commodity. The id comes from the stop that was returned in the quote response.</td></tr><tr><td>pallets</td><td>int</td><td>Yes</td><td>Pallets in the commodity. The total pallets of all the commodities must match the pallets from the quote response.</td></tr><tr><td>feet</td><td>int</td><td>Yes</td><td>Linear feet of the commodity. The total feet of all the commodities must match the feet from the quote response.</td></tr><tr><td>weight</td><td>int</td><td>Yes</td><td>Weight of the commodity. The total weight of all the commodities must match the weight of quote response.</td></tr><tr><td>pieces</td><td>int</td><td>No</td><td>Optional number of pieces for the commodity.</td></tr><tr><td>notes</td><td>string</td><td>No</td><td>Any notes for the commodity. Any relevant ID numbers can go here as well.</td></tr></tbody></table>

## Example Request

### Example 1 - request with 1 pickup and 1 delivery

```json
{
  "quoteNumber":"G1430621",
  "referenceNumber":"6e6666sd33",
  "tenderStops":[
    {
      "shipConID":3045341,
      "referenceNumber":"12223",
      "date":"2018-02-15",
      "timeFrom":"7:00AM",
      "timeTo":"7:00AM",
      "contactName":"Sterling Archer"
    },
    {
      "shipConID":3045342,
      "referenceNumber":"12224"
    }
  ],
  "tenderCommodities":[
    {
      "shipperID":3045341,
      "consigneeID":3045342,
      "pallets":5,
      "feet":6,
      "weight":1000,
      "notes":"Hello"
    }
  ]
}
```

### Example 2 - request with multiple stops

```json
{
  "quoteNumber":"P1430650",
  "referenceNumber":"6e6666sd33",
  "tenderStops":[
    {
      "shipConID":3045413,
      "name":"The Beverly Hills Hotel",
      "line1":"9641 Sunset Blvd",
      "city":"Beverly Hills",
      "state":"CA",
      "zip":"90210",
      "referenceNumber":"12223",
      "date":"2018-04-16",
      "timeFrom":"07:00",
      "timeTo":"07:00",
      "contactName":"Sterling Archer"
    },
    {
      "shipConID":3045414,
      "name":"Alfred Coffee Silverlake",
      "line1":"3337 Sunset Blvd",
      "city":"Los Angeles",
      "state":"CA",
      "zip":"90026",
      "referenceNumber":"12224",
      "date":"2018-04-16",
      "timeFrom":"12:00",
      "timeTo":"13:00",
      "contactName":"Alfred"
    },
    {
      "shipConID":3045415,
      "name":"University of Illinois",
      "line1":"750 S Halsted St",
      "city":"Chicago",
      "state":"IL",
      "zip":"60607",
      "referenceNumber":"12225",
      "date":"2018-04-23",
      "timeFrom":"12:00",
      "timeTo":"13:00",
      "contactName":"Michael Jordan"
    }
  ],
  "tenderCommodities":[
    {
      "shipperID":3045413,
      "consigneeID":3045415,
      "pallets":4,
      "feet":6,
      "weight":6000,
      "notes":""
    },
    {
      "shipperID":3045414,
      "consigneeID":3045415,
      "pallets":6,
      "feet":8,
      "weight":7000,
      "notes":"Coffee"
    }
  ]
}
```

## Tender Response

### Response Object

<table data-full-width="true"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>int</td><td>Yes</td></tr><tr><td>loadId</td><td>int</td><td>The ID of the newly created load. This is used to identify the load in White Arrow's system.</td></tr><tr><td>quoteNumber</td><td>string</td><td>Original quote number sent.</td></tr><tr><td>serviceLevel</td><td>string</td><td>The service level of the load.</td></tr><tr><td>referenceNumber</td><td>string</td><td>The quoting party's reference number.</td></tr><tr><td>totalRate</td><td>float</td><td>The total price of the load.</td></tr><tr><td>baseRate</td><td>float</td><td>The base rate of the load.</td></tr><tr><td>fuelRate</td><td>float</td><td>The fuel surcharge of the load.</td></tr><tr><td>extra</td><td>float</td><td>The total of all accessorials excluding fuel surcharge.</td></tr><tr><td>accessorials</td><td>array</td><td>An array of accessorial objects. See Below.</td></tr><tr><td>stops</td><td>array</td><td>An array of stop objects. See Below.</td></tr></tbody></table>

## Accessorial Object

<table data-full-width="true"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>costAmount</td><td>float</td><td>The cost of the accessorial.</td></tr><tr><td>name</td><td>string</td><td>The name of the accessorial</td></tr><tr><td>accessorialId</td><td>int</td><td>The id of the accessorial.</td></tr><tr><td>stopId</td><td>int</td><td>The id of the stop object this accessorial is for. Omitted if the accessorial is not part of a stop.</td></tr><tr><td>stopName</td><td>string</td><td>The name of the stop object this accessorial is for. Omitted if the accessorial is not part of a stop.</td></tr></tbody></table>

### Stop Object

<table data-full-width="true"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>int</td><td>The unique id of the stop.</td></tr><tr><td>name</td><td>string</td><td>The name of the location of the stop.</td></tr><tr><td>type</td><td>string</td><td>Either shipper (pickup) or consignee (delivery)</td></tr><tr><td>referenceNumber</td><td>string</td><td>The supplied reference number / BOL number / Pro Number for the stop.</td></tr><tr><td>date</td><td>string</td><td>The date of the stop in the form '2016-01-31' (YEAR-MONTH-DAY).</td></tr><tr><td>timeFrom</td><td>string</td><td>The earliest time of an appointment window for a stop in the form '14:00' <strong>ALL TIMES ARE THE LOCAL TIME OF THE STOP</strong>.</td></tr><tr><td>timeTo</td><td>string</td><td>The latest time of an appointment window for a stop in the form '14:00' <strong>ALL TIMES ARE THE LOCAL TIME OF THE STOP</strong>.</td></tr><tr><td>address</td><td>object</td><td>An object representing the address of the stop. See Below.</td></tr></tbody></table>

#### Address Object

<table data-full-width="true"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>locationId</td><td>int</td><td>If the address is a valid location then the id is returned.</td></tr><tr><td>city</td><td>string</td><td>The city name.</td></tr><tr><td>state</td><td>string</td><td>The two letter state abbreviation. Ex "CA"</td></tr><tr><td>zip</td><td>string</td><td>The zip code of the address.</td></tr><tr><td>latitude</td><td>float</td><td>The latitude of the address.</td></tr><tr><td>longitude</td><td>float</td><td>The longitude of the address.</td></tr></tbody></table>

### Example 1 - response with 1 pickup and 1 delivery

```json
{
  "id":19,
  "loadId":744068,
  "quoteNumber":"P1430635",
  "quoteId":1430635,
  "serviceLevel":"premium",
  "referenceNumber":"6e6666sd33",
  "totalRate":1628,
  "baseRate":1379,
  "fuelRate":249,
  "extra":0,
  "accessorials":[],
  "stops":[
    {
      "id":3045373,
      "name":"Casper c/o Iron Mountain",
      "referenceNumber":"12223",
      "type":"shipper",
      "date":"2018-4-15",
      "timeFrom":"07:00",
      "timeTo":"07:00",
      "address":{
        "locationId":70678,
        "line1":"8595 Milliken Ave",
        "city":"Rancho Cucamonga",
        "state":"CA",
        "zip":"91730",
        "latitude":34.0973,
        "longitude":-117.555
      }
    },
    {
      "id":3045374,
      "name":"Mule Creek State Prison - DOC",
      "referenceNumber":"12224",
      "type":"consignee",
      "address":{
        "locationId":74248,
        "line1":"4001 CA-104",
        "city":"Plymouth",
        "state":"CA",
        "zip":"95669",
        "latitude":38.3687,
        "longitude":-120.959
      }
    }
  ]
}
```

## Example 2 - response with multiple stops

```json
{
  "id":20,
  "loadId":744073,
  "quoteNumber":"P1430650",
  "quoteId":1430650,
  "serviceLevel":"premium",
  "referenceNumber":"6e6666sd33",
  "totalRate":1229,
  "baseRate":1041,
  "fuelRate":188,
  "extra":0,
  "accessorials":[],
  "stops":[
    {
      "id":3045413,
      "name":"The Beverly Hills Hotel",
      "referenceNumber":"12223",
      "type":"shipper",
      "date":"2018-4-16",
      "timeFrom":"07:00",
      "timeTo":"07:00",
      "address":{
        "locationId":74262,
        "line1":"9641 Sunset Blvd",
        "city":"Beverly Hills",
        "state":"CA",
        "zip":"90210",
        "latitude":34.0818,
        "longitude":-118.413
      }
    },
    {
      "id":3045414,
      "name":"Alfred Coffee Silverlake",
      "referenceNumber":"12224",
      "type":"shipper",
      "date":"2018-4-16",
      "timeFrom":"12:00",
      "timeTo":"13:00",
      "address":{
        "locationId":74263,
        "line1":"3337 Sunset Blvd",
        "city":"Los Angeles",
        "state":"CA",
        "zip":"90026",
        "latitude":34.0875,
        "longitude":-118.276
      }
    },
    {
      "id":3045415,
      "name":"University of Illinois",
      "referenceNumber":"12225",
      "type":"consignee",
      "date":"2018-4-23",
      "timeFrom":"12:00",
      "timeTo":"13:00",
      "address":{
        "locationId":74264,
        "line1":"750 S Halsted St",
        "city":"Chicago",
        "state":"IL",
        "zip":"60607",
        "latitude":41.8719,
        "longitude":-87.648
      }
    }
  ]
}
```