Create Spot Bid

Submit a spot bid on a biddable domestic shipment routing. Customer, carrier, origin, destination, mode and contract type come from the API key and the routing; the origin factory is left empty when the routing picks up from more than one factory. The DO Email custom column (etv2l0rcfp) is required. Resubmitting the same all-in rate (linehaul + fuel) and expiry on a routing returns your existing bid instead of creating another. Send an Idempotency-Key header to make retries safe: a repeat with the same key returns the bid the first request created (kept 24h), and a repeat while the first is still running returns 409.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 36

The domestic shipment routing being bid on.

number
required
0 to 999999.9999

Linehaul rate in USD.

number
0 to 999999.9999
Defaults to 0

Total fuel charge in USD.

date-time
required

When the bid expires. Must be in the future. An offset is converted to UTC; a value without an offset is read as UTC.

length ≤ 2048
custom_columns
array of objects
Defaults to []

Values for the customer's domestic_invoice_contract custom columns, keyed by field_key (see GET /api/v2/custom_column/registry/domestic_invoice_contract).

Custom Columns
Headers
length between 1 and 255
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json