# 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.

Endpoint: POST /loads/{loadId}/carriers/{carrierId}/bounce
Version: 1.0.0
Security: BearerAuth

## Path parameters:

  - `loadId` (string, required)

  - `carrierId` (string, required)

## Request fields (application/json):

  - `reason` (string)
    Reason for removing a carrier from a load
    Enum: "TONU", "BOUNCED", "RATE_DISPUTE", "EQUIPMENT_ISSUE", "DRIVER_ISSUE", "TIMING_ISSUE", "OTHER"

  - `reasonText` (string)
    Additional reason details

## Response 200 fields (application/json):

  - `id` (string)

  - `carrier` (object)
    Enhanced reference to a carrier resource (returned in responses).
Includes full carrier details in addition to id/key.

Note: Does NOT include nested references (contacts, etc.) to prevent recursion.
Maximum nesting depth: 1 level.

  - `carrier.id` (string, required)
    Carrier UUID
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `carrier.key` (string,null)
    Client-defined reference ID if set
    Example: "ERP-CARRIER-SWIFT"

  - `carrier.name` (string, required)
    Carrier company name
    Example: "Swift Transportation"

  - `carrier.phoneNumber` (string,null)
    Primary phone number
    Example: "+1-555-987-6543"

  - `carrier.email` (string,null)
    Primary email address
    Example: "dispatch@swifttrans.com"

  - `carrier.createdAt` (string, required)
    When the carrier was created
    Example: "2025-01-15T10:00:00Z"

  - `carrier.updatedAt` (string, required)
    When the carrier was last updated
    Example: "2025-01-15T14:30:00Z"

  - `carrier.deletedAt` (string,null)
    When the carrier was soft deleted (null if active)

  - `contact` (object)

  - `contact.name` (string)

  - `contact.phone` (string,null)

  - `contact.email` (string,null)

  - `status` (string)
    Status of the carrier assignment.
- ACTIVE: Carrier is actively assigned
- TONU: Truck Ordered Not Used (carrier dispatched but cancelled)
- BOUNCED: Carrier bounced/rejected load
    Enum: "ACTIVE", "TONU", "BOUNCED"

  - `billingStatus` (string)
    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
    Enum: "AWAITING_INVOICE", "INVOICE_IN_REVIEW", "APPROVED_TO_PAY", "PAID"

  - `bookedAt` (string,null)

  - `dispatchedAt` (string,null)

  - `charges` (array)
    Flattened charges array

  - `charges.chargeCode` (object)
    Reference to another resource (returned in responses)

  - `charges.chargeCode.id` (string, required)
    Resource UUID

  - `charges.description` (string,null)

  - `charges.amount` (number)

  - `charges.quantity` (number)

  - `totalCost` (number,null)
    Sum of all charges

  - `driverName` (string,null)

  - `driverPhone` (string,null)

  - `truckNumber` (string,null)

  - `trailerNumber` (string,null)

  - `createdAt` (string)

  - `updatedAt` (string,null)

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 404 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 409 fields (application/problem+json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message