Bill Payments8

Bills11

Carrier Contacts5

Carrier Factors6

Carrier Payment Methods5

Carriers8

Companies5

Credit Memos8

Customer Contacts5

Customers8

Documents20

Invoices11

Loads13

Location Contacts5

Locations6

Payment Terms5

Payments6

Quotes6

Reference Data3

Saved Searches5

Search1

Services5

Shipments16

Stops5

Teams5

Users6

Vendor Contacts5

Vendor Payment Methods5

Vendors8

Webhooks

Event Notifications1

Loads

Bounce carrier

Changed on Oct 8, 2026

Mark carrier as bounced (rejected load without payment), as the TMS "Remove carrier" does. carrierId is the load carrier's ID (loadCarrierId from POST /loads/{id}/add-carrier).

What happens

LoadCarrier status changes to BOUNCED
The load goes back to sourcing and the shipment to planning, ready for another carrier
No payment is recorded

Prerequisites

The load carrier is active
The load is not delivered or canceled, and its shipment is not delivered
An LTL load can be bounced only before dispatch (sourcing, selected or booked)
carrierId is the load's current carrier (its first active one), and the load is active: not canceled and with no TONU'd carrier

When to use

Use bounce when carrier rejects the load before dispatch, or fails to show up without prior notice.

For carriers who were dispatched but cancelled, use TONU instead.

post/loads/{loadId}/carriers/{carrierId}/bounce

Request

Base URL: https://api.mvmnt.io/v1
URL: https://api.mvmnt.io/v1/loads/{loadId}/carriers/{carrierId}/bounce
Auth: HTTP bearer

Path parameters

loadIdstring required

carrierIdstring required

Request body

reason'CAN_NO_LONGER_TAKE_LOAD' | 'LOAD_GIVEN_BACK' | 'RATE_CON_REJECTED' | 'OTHER' required

Why the carrier is bounced — the reasons the TMS offers for a bounce.

reasonTextstring

Additional reason details

Response

Carrier bounced successfully

idstring uuid

status'ACTIVE' | 'TONU' | 'BOUNCED'

Status of the carrier assignment.

ACTIVE: Carrier is actively assigned
TONU: Truck Ordered Not Used (carrier dispatched but cancelled)
BOUNCED: Carrier bounced/rejected load

billingStatus'AWAITING_INVOICE' | 'INVOICE_IN_REVIEW' | 'APPROVED_TO_PAY' | 'PAID'

Billing status for the load (AP side).

AWAITING_INVOICE: Waiting for carrier invoice
INVOICE_IN_REVIEW: Invoice received, under review
APPROVED_TO_PAY: Approved for payment
PAID: Paid to carrier

bookedAtstring date-time nullable

dispatchedAtstring date-time nullable

removedAtstring date-time nullable

When this assignment was removed from the load (bounce, TONU, rebook). Removed assignments stay in carriers as history but their charges are excluded from the load totalCost.

totalCostnumber nullable

Sum of all charges

driverNamestring nullable

driverPhonestring nullable

truckNumberstring nullable

trailerNumberstring nullable

createdAtstring date-time

updatedAtstring date-time nullable

Example response

{
  "carrier": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-CARRIER-SWIFT",
    "name": "Swift Transportation",
    "phoneNumber": "+1-555-987-6543",
    "email": "dispatch@swifttrans.com",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  }
}

Changes

Oct 8, 2026f67041fe5cb9 Revision changes
- breaking
  request body became required
- breaking
  the request property became required
- breaking
  removed the enum value CONSIGNEE_NOT_READY_FOR_DEL of the request property
- breaking
  removed the enum value CUSTOMER_NOT_READY_FOR_PU of the request property
- breaking
  removed the enum value FORGOT_TO_BOUNCE_CARRIER of the request property
- breaking
  the request property's maxLength was decreased to 250
Oct 7, 20262cd6ecfbeb82 Revision changes
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (3 revisions)