Create an RFQ
POST/rfqs
Purpose (Flow C, step 1): Create an open RFQ from a shipment payload without creating a shipment.
Returns rfqId (RFQ number). Next steps: 1. GET /rfqs/{rfqId}/quotes — read stored shipper-facing quotes (may be empty until quotes are generated) 2. POST /rfqs/{rfqId}/accept-quote — accept with quoteId only
Do not use this if you want an immediate shipment — use POST /shipments (Flow A) or POST /quotes + POST /accept-quote (Flow B). When called with a DEVELOPMENT API key, this endpoint validates and returns a sample response only.
Request
Responses
- 200
- 400
- 403
- 404
- 422
- 500
RFQ created (or validated in DEVELOPMENT mode).
Bad request (validation or duplicate reference).
API key is invalid or expired.
Shipper not found.
RFQ processing validation error.
Internal server error.