v1

latestOpenAPI 3.1.0Proprietary2026-08-06177398877.4 KB
Loads

Report TONU

Report Truck Ordered Not Used (TONU).

What happens

  • LoadCarrier status changes to TONU
  • TONU costs are recorded if provided
  • Optionally creates a replacement load

When to use

Use TONU when:

  • Carrier was dispatched but load was cancelled
  • Carrier arrived but freight wasn't ready
  • Carrier was turned away at shipper

TONU typically involves some payment to the carrier.

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

Path parameters

loadIdstring required
carrierIdstring required

Request body

reasonstring

Reason for TONU

createReplacementLoadboolean

Whether to create a replacement load

Response

TONU reported successfully

replacementLoadIdstring uuid nullable

New load ID if replacement was requested

Example response

{
  "loadCarrier": {
    "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"
    },
    "charges": [
      {
        "chargeCode": {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "key": "ERP-USER-12345"
        }
      }
    ]
  }
}