Sign in
Loads

Bounce carrier

Mark carrier as bounced (rejected load without payment).

What happens

  • LoadCarrier status changes to BOUNCED
  • Carrier is removed from active execution
  • No payment is recorded

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

Path parameters

loadIdstring required
carrierIdstring required

Request body

reason'CAN_NO_LONGER_TAKE_LOAD' | 'LOAD_GIVEN_BACK' | 'RATE_CON_REJECTED' | 'CUSTOMER_NOT_READY_FOR_PU' | 'CONSIGNEE_NOT_READY_FOR_DEL' | 'FORGOT_TO_BOUNCE_CARRIER' | 'OTHER'

Reason for removing a carrier from a load. Whether the removal counts as a bounce or a TONU is the removal type, tracked separately.

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

Changed in 1 of the 4 revisions of this API.619

  • ce0e9003047c619See the full diff
    • ▲

      removed the enum value BOUNCED of the request property reason

      request-property-enum-value-removed

    • ▲

      removed the enum value DRIVER_ISSUE of the request property reason

      request-property-enum-value-removed

    • ▲

      removed the enum value EQUIPMENT_ISSUE of the request property reason

      request-property-enum-value-removed

    • ▲

      removed the enum value RATE_DISPUTE of the request property reason

      request-property-enum-value-removed

    • ▲

      removed the enum value TIMING_ISSUE of the request property reason

      request-property-enum-value-removed

    • ▲

      removed the enum value TONU of the request property reason

      request-property-enum-value-removed

    • ●

      removed the optional property charges/items/chargeCode from the response with the 200 status

      response-optional-property-removed

    • ○

      added the new CAN_NO_LONGER_TAKE_LOAD enum value to the request property reason

      request-property-enum-value-added

    • ○

      added the new CONSIGNEE_NOT_READY_FOR_DEL enum value to the request property reason

      request-property-enum-value-added

    • ○

      added the new CUSTOMER_NOT_READY_FOR_PU enum value to the request property reason

      request-property-enum-value-added

    • ○

      added the new FORGOT_TO_BOUNCE_CARRIER enum value to the request property reason

      request-property-enum-value-added

    • ○

      added the new LOAD_GIVEN_BACK enum value to the request property reason

      request-property-enum-value-added

    • ○

      added the new RATE_CON_REJECTED enum value to the request property reason

      request-property-enum-value-added

    • ○

      added the optional property charges/items/chargeCodeId to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property charges/items/rate to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property removedAt to the response with the 200 status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog