---
title: "Send counter offer to carrier"
method: POST
path: "/v2/tms/offers/{offer_id}/carriers/{carrier_id}/counter"
tags: ["v2", "tms", "Load Offers"]
---

# Send counter offer to carrier

`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)
- URL: `https://api.mentium.io/v2/tms/offers/{offer_id}/carriers/{carrier_id}/counter`
- Auth: HTTP bearer

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

## Path parameters

- `offer_id` string, required
- `carrier_id` string, required

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- CounterOfferRequest: Request body for broker to send counter offer to carrier
  - `carrier_rate_amount` number, required: The carrier rate submitted by the broker.
  - `message` string, nullable: Optional message to send with the counter offer

## Response `200`

Successful Response

- CounterOfferResponse: Response from counter offer operation
  - `success` boolean, required
  - `carrier_offer_id` string, required
  - `carrier_rate_amount` number, required
  - `message` string, nullable
  - `email_sent` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)