GOgoaugment
Load Management

Get load by load number

Retrieve enriched load data by load number (brokerage load ID). Returns the full LoadV2 format including carrier details, tracking events, reference numbers, notes, subscribers, and shipment information.

get/v2/loads

Request

Query parameters

loadNumberstring required

The load number (brokerage load ID)

Response

Load found and returned successfully

brokerageLoadIdstring required

The load number (brokerage load ID) - this is your load identifier

brokerageLoadInternalIdstring nullable

Optional internal load ID in the TMS

status'DRAFT' | 'CUSTOMER_CONFIRMED' | 'COVERED' | 'DISPATCHED' | 'AT_PICKUP' | 'IN_TRANSIT' | 'AT_DELIVERY' | 'DELIVERED' | 'POD_COLLECTED' | 'PAID' | 'CANCELED' | 'ERROR' | 'ARCHIVED' required

The load's lifecycle status. CANCELED, ERROR, and ARCHIVED are terminal or administrative states rather than lifecycle stages; a load in any status can move to one of them. Validation requirements vary by status — see Load Status Validation.

mode'DRAYAGE' | 'EXPEDITE' | 'FTL' | 'LTL' | 'PARTIAL' | 'null' nullable

Load transportation mode

loadType'CONTRACT' | 'DEDICATED' | 'PROJECT' | 'SPOT' | 'null' nullable

Type of load rate

totalMilesnumber nullable

Total estimated mileage for the entire route

equipmentstring nullable

Equipment type

equipmentDescriptionstring nullable

Free-text equipment description

accessorialsstring[] required

List of accessorials for the load

tarpSizestring nullable

Tarp size requirement

commoditystring nullable

Commodity description

service'HOTSHOT' | 'PARTIAL' | 'STANDARD' | 'TIME_CRITICAL' | 'VOLUME' | 'null' nullable

Service type for the load

highValueAmountnumber nullable

High value amount in USD

targetRatenumber nullable

Target rate in USD

maxRatenumber nullable

Maximum bid amount in USD

totalRatenumber nullable

Total rate for the load in USD

totalCarrierRatenumber nullable

Total carrier rate in USD

bidExpirationstring date-time nullable

Bid expiration time

isPostedToDATboolean required

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

isPostedToHighwayboolean nullable

Indicates whether the load has been posted to Highway

customerNamestring nullable

Primary customer name

customerIdstring nullable

Primary customer identifier

podCollectionStatus'NOT_STARTED' | 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' required

POD collection workflow status

lastLocationUpdatestring date-time nullable

Timestamp of the last location update

groupExternalIdstring nullable

The external identifier for the group this load belongs to.

createdAtstring date-time required

Timestamp when the load was created

updatedAtstring date-time required

Timestamp when the load was last updated

Example response

{
  "brokerageLoadId": "LOAD-12345",
  "route": [
    {
      "sequenceNumber": 1,
      "timezone": "America/Los_Angeles",
      "customData": {
        "pickupNumber": "PU-111",
        "bolNumber": "0007031665",
        "dock": {
          "door": "42"
        }
      }
    }
  ],
  "equipment": "REEFER",
  "trackingEvents": [
    {
      "nextSequence": 2,
      "nextEtaUtc": "2025-08-21T12:34:56Z",
      "eventType": "INFO",
      "eventSource": "MACROPOINT",
      "eventUtc": "2025-08-21T12:34:56Z",
      "city": "St Louis",
      "country": "US",
      "stateOrProvince": "MO",
      "latitude": 38.56045466,
      "longitude": -90.4000096,
      "temperatureF": 26,
      "notes": "Location update received. Locator: 6166485924, Source: Ping",
      "dispatcher": {
        "phone": "+12081234567"
      },
      "driver": {
        "phone": "+12081234567"
      }
    }
  ],
  "externalTrackingStatus": {
    "message": "Tracking Now",
    "updatedAt": "2025-08-21T12:34:56Z"
  },
  "customers": [
    {
      "name": "Acme Corporation",
      "customerId": "ACME-001"
    }
  ],
  "loadShipments": [
    {
      "accessorials": [
        "AFTER_HOURS"
      ],
      "route": {
        "expectedArrivalWindowStart": "2025-08-21T12:34:56Z",
        "expectedArrivalWindowEnd": "2025-08-21T12:34:56Z",
        "actualArrivalTime": "2025-08-21T12:34:56Z",
        "actualCompletionTime": "2025-08-21T12:34:56Z",
        "expectedDropWindowStart": "2025-08-21T12:34:56Z",
        "expectedDropWindowEnd": "2025-08-21T12:34:56Z",
        "mustArriveByDate": "2025-08-21T12:34:56Z",
        "customData": {
          "pickupNumber": "PU-111",
          "bolNumber": "0007031665",
          "dock": {
            "door": "42"
          }
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.