LoadRequest

  • brokerage
    Type: object · Brokerage
    required
    • contacts
      Type: array object[]
  • load
    Type: object · Load
    required
    • loadNumber
      Type: string
      required
    • mode
      enum
      required
      values
      • DRAYAGE
      • FTL
      • LTL
    • route
      Type: array object[] · LoadRouteStop[]
      required
    • status
      enum
      required
      values
      • DRAFT
      • CUSTOMER_CONFIRMED
      • COVERED
      • DISPATCHED
      • AT_PICKUP
    • accessorials
      Type: array string[] · AccessorialsEnum[]
    • bidExpiration
      • Type: string · InputDateTimeUtcFormat: date-time

        Bid expiration time in UTC, or with a specific timezone offset

    • bookedRate
      Type: number

      Booked rate in USD

    • brokerageLoadInternalId
      Type: string

      Optional internal load ID in the TMS. Use loadNumber as the main ID.

    • customData
      Type: object · LoadCustomDatanullable

      Optional client-specific metadata for the load. Use string keys; each value may be a string, number, boolean, array of JSON-safe values, or a nested object with the same rules. The serialized JSON must not exceed 10,000 characters.

      If you want Augie to use values from customData in automated workflows, coordinate the expected keys and meanings with Augment. Your SOPs or workflow instructions may need to be updated so Augie knows when and how to reference those values.

      On update, sending this field replaces the stored value. Omitting it preserves the existing value, while sending null clears it.

    • dimensions
      Type: object

      Optional dimensions object. If provided, all dimension fields are required. All dimensions are in inches.

    • equipment
      Type: object

      Optional equipment details. If provided, equipmentType is required

    • externalTrackingStatus
      Type: object · ExternalTrackingStatus

      External tracking status information. When updating a load: - If omitted, the existing externalTrackingStatus value is preserved unchanged - If explicitly set to null, the externalTrackingStatus is cleared - If provided with a value, the externalTrackingStatus is updated to that value

    • groupExternalId
      Type: string | null

      The external identifier used to associate this load with a group. Used during create/update to resolve the internal groupKey.

    • highValueAmount
      Type: number

      High value amount in USD

    • isPostedToDAT
      Type: boolean

      Indicates whether the load has been posted to DAT load board. This is required for Augie to search for loads using lane information (pick up and drop off city and state).

    • items
      Type: array object[] · LoadItem[]

      Optional array of items. If provided, each item must include quantity and totalWeightLbs. Use packagingUnit to describe how the item is packaged and handlingUnit to describe how the freight is handled or moved.

    • maximumBulkHeadTemperature
      Type: number

      Maximum bulkhead temperature requirement in Fahrenheit

    • maximumTemperature
      Type: number

      Maximum temperature requirement in Fahrenheit

    • maxRate
      Type: number

      Maximum bid amount in USD

    • minimumBulkHeadTemperature
      Type: number

      Minimum bulkhead temperature requirement in Fahrenheit

    • minimumTemperature
      Type: number

      Minimum temperature requirement in Fahrenheit

    • notes
      Type: array object[] · LoadNote[]

      Operational notes about the load. Use this field to send context about actions taken on the load (e.g. broker instructions, status updates). On update, the provided notes are merged with existing notes.

    • rateType
      enum
      values
      • CONTRACT
      • DEDICATED
      • PROJECT
      • SPOT
    • referenceNumbers
      Type: array object[]
    • service
      enum

      Service type for the load

      values
      • HOTSHOT
      • PARTIAL
      • STANDARD
      • TIME_CRITICAL
      • VOLUME
    • shipperRate
      Type: number

      Shipper rate in USD

    • targetRate
      Type: number

      Target rate in USD

    • tarpSize
      Type: string

      Tarp size requirement

    • totalMiles
      Type: number

      Total estimated mileage for the entire route of a load

    • weight
      Type: number

      Total weight in pounds (lbs)

  • carrier
    Type: object · Carrier
    • dotNumber
      Type: integer
      required

      Integer numbers.

    • name
      Type: string
      required
    • address
      Type: object · CarrierAddress

      Carrier address on a load. Optional on the parent object; when present, include every required field below.

    • carrierId
      Type: string
    • contacts
      Type: array object[] · CarrierContact[]

      Optional contact object. If provided, role is required.

    • drivers
      Type: array object[]
    • mcNumber
      Type: integer

      Integer numbers.

    • scac
      Type: string
  • carrierPaymentStatuses
    Type: array object[] · CarrierPaymentStatus[]

    Per-carrier payment status entries for this load. Each entry represents the payment outcome for one carrier on the load (e.g., TONU + linehaul on a co-brokered load yields two entries). Sending this field replaces any prior set of statuses for the load.

    • carrierId
      Type: string
      required

      Brokerage-side external carrier identifier (the externalId used elsewhere in the API). Resolved against (brokerageKey, carrierId), which is unique. Required on every entry.

    • status
      Type: string enum
      required

      Explicit payment status. OTHER is a catch-all for states not yet promoted to first-class enum values (e.g., PARTIAL, APPROVED, DISPUTED, FAILED); additional values may be added in a backward-compatible way.

      values
      • PAID
      • SCHEDULED
      • OTHER
    • actualPaymentDate
      Type: string Format: date

      Actual payment date (YYYY-MM-DD, UTC).

    • paymentMethod
      Type: string enum

      Payment method used.

      values
      • ACH
      • CHECK
    • paymentReferenceNumbers
      Type: array string[]

      Broker-side transaction or confirmation IDs associated with the payment (e.g., TriumphPay confirmation IDs). A list supports split payments and multiple confirmation IDs per payment.

    • scheduledPaymentDate
      Type: string Format: date

      Scheduled payment date (YYYY-MM-DD, UTC).

  • customer
    Type: object · Customer
    • name
      Type: string
      required
    • customerId
      Type: string
  • trackingEvents
    Type: array object[] · TrackingEvent[]

    Providing this field replaces all existing tracking events for the Load, including an empty array, which clears them. Omit the field to preserve existing tracking events. To append events instead of replacing them, use the POST /v2/loads/tracking endpoint.

    • eventSource
      enum
      required
      values
      • 4KITES
      • CARRIER_API
      • HIGHWAY
      • MACROPOINT
      • P44
    • eventType
      enum
      required
      values
      • DELAYED
      • INFO
      • PICKED_UP
      • PING
      • COVERED
      • DISPATCHED
    • eventUtc
      required
      • Type: string · InputDateTimeUtcFormat: date-time

        Event time in UTC, or with a specific timezone offset

    • city
      Type: string
    • dispatcher
      Type: object · TrackingEventContact

      Contact information for a person associated with a tracking event.

    • driver
      Type: object · TrackingEventContact

      Contact information for a person associated with a tracking event.

    • latitude
      Type: number
    • longitude
      Type: number
    • nextEtaUtc
      • Type: string · InputDateTimeUtcFormat: date-time

        Next estimated arrival time in UTC, or with a specific timezone offset

    • nextSequence
      Type: integer

      Integer numbers.

    • notes
      Type: string
    • postalCode
      Type: string
    • stateOrProvince
      Type: string
    • temperatureF
      Type: number