v2
tms
Load Offers

Send counter offer to carrier

Send a counter offer to a carrier who has submitted a bid.

This endpoint is used when:
- Carrier submitted a bid that differs from the original offer
- Broker wants to negotiate by sending a counter amount

The carrier will receive an email notification with the counter offer
and a link to respond (accept, counter again, or decline).

**Flow:**
1. Carrier submits bid → status becomes NEGOTIATING
2. Broker sends counter → carrier notified
3. Carrier can: accept counter (ACCEPTED/BOOKED), submit new bid, or decline
post/v2/tms/offers/{offer_id}/carriers/{carrier_id}/counter

Request

  • Base URL
    https://api.mentium.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

offer_idstring required
carrier_idstring required

Headers

mentium-workspace-idstring nullable

Request body

carrier_rate_amountnumber required

The carrier rate submitted by the broker.

messagestring nullable

Optional message to send with the counter offer

Response

Successful Response

successboolean required
carrier_offer_idstring required
carrier_rate_amountnumber required
messagestring nullable
email_sentboolean

Changes

No recorded changes to this operation across all 2 revisions of this API.