Create a quote
POST/api/quotes
Prices a shipment and saves the quotation; every call saves a new one. Coordinates are required: resolve free text through POST /api/address/resolve first. The cheapest option wins; when no single vehicle fits, a multi-vehicle composition may be offered instead (vehicle null, vehicles set).
Signature only; a user session is not accepted. X-Sender-Account-Id is optional here: without it the quote has no owner, and the first sender of your organization to open it with Get a quote becomes its owner. A sender named here must belong to your organization (403 forbidden otherwise).
Errors answer { error, detail, request_id } (QuoteCreateError), except the 401 and 403, which answer { error }.
Request
Responses
- 200
- 400
- 401
- 403
- 422
- 500
- 503
The saved quote.
Validation failed (missing_required_field; detail names the fields).
Signature missing or invalid.
X-Sender-Account-Id is malformed, unknown or belongs to another organization.
unsupported_route: nothing can serve this route. no_vehicle_fits: no vehicle or composition can carry the cargo (detail gives the main reason, e.g. weight_over). unsupported_addon: no option supports every requested add-on (detail lists them).
Internal error, including every pricing call failing. Reported with code missing_required_field.
load_planning_unavailable: the load planner is temporarily unavailable. Retry after Retry-After seconds.
Response Headers
Seconds to wait before retrying.