---
title: "Get load by load number"
method: GET
path: "/v2/loads"
tags: ["Load Management"]
---

# Get load by load number

`GET /v2/loads`

## Request

- Base URL: `https://api.prod.goaugment.com`
- URL: `https://api.prod.goaugment.com/v2/loads`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/goaugment/apis/augment-api/docs/v2/loads/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Query parameters

- `loadNumber` string, required

## Response `200`

Load found and returned successfully

- LoadV2Response: Enriched load data including tracking events, reference numbers, notes, customers, and shipment information.
  - `brokerageLoadId` string, required: The load number (brokerage load ID) - this is your load identifier
  - `brokerageLoadInternalId` string, 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](/guide/start-developing/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
  - `route` RouteStop[], required: Route stops sorted by sequence number ascending
    - `sequenceNumber` integer, required: The sequence number of the stop in the route (1-indexed)
    - `externalId` string, nullable: External ID for the stop (if provided)
    - `activityType` 'PICKUP' | 'DELIVERY', required: Type of activity at this stop
    - `address` object, required: Stop address
      - `name` string, nullable: Location name
      - `company` string, nullable: Company name
      - `street1` string, nullable: Street address line 1
      - `street2` string, nullable: Street address line 2
      - `city` string: City name
      - `stateOrProvince` string: State or province code
      - `postalCode` string, nullable: Postal or ZIP code
      - `country` string: Country code (2-letter ISO)
    - `timezone` string, nullable: IANA timezone for the stop location
    - `stopNotes` string, nullable: Notes for this stop
    - `facilityCode` string, nullable: Facility code
    - `scheduleTypes` string[]: Scheduling types for the stop
    - `expectedStopWindowStart` string, date-time, nullable: Expected stop window start time
    - `expectedStopWindowEnd` string, date-time, nullable: Expected stop window end time
    - `expectedDropWindowStart` string, date-time, nullable: Expected drop window start time (for drop trailers)
    - `expectedDropWindowEnd` string, date-time, nullable: Expected drop window end time (for drop trailers)
    - `actualArrivalTime` string, date-time, nullable: Actual arrival time at the stop
    - `actualDepartureTime` string, date-time, nullable: Actual departure time from the stop
    - `mustArriveByDate` string, date-time, nullable: The date and time by which the carrier must arrive at this stop
    - `customData` StopCustomData, nullable: Optional client-specific metadata for this stop. 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 2,000 characters. Use this field to attach stop-specific references such as pickup numbers, BOL numbers, or PO numbers to individual stops rather than flattening them into load-level `customData`. On update, sending this field replaces the stored value for that stop. Because routes are replaced wholesale on every write, omitting `customData` from a stop clears it to `null`. Send `null` explicitly to clear a previously stored value.
  - `totalMiles` number, nullable: Total estimated mileage for the entire route
  - `equipment` string, nullable: Equipment type
  - `equipmentDescription` string, nullable: Free-text equipment description
  - `accessorials` string[], required: List of accessorials for the load
  - `weight` object, nullable: Total weight information
    - `value` number
    - `unit` 'LB' | 'KG'
  - `dimensions` object, nullable: Load dimensions
    - `lengthInches` integer
    - `widthInches` integer
    - `heightInches` integer
  - `minimumTemperature` object, nullable: Minimum temperature requirement
    - `value` number
    - `unit` 'F' | 'C'
  - `maximumTemperature` object, nullable: Maximum temperature requirement
    - `value` number
    - `unit` 'F' | 'C'
  - `tarpSize` string, nullable: Tarp size requirement
  - `minimumBulkHeadTemperature` object, nullable: Minimum bulkhead temperature requirement
    - `value` number
    - `unit` string
  - `maximumBulkHeadTemperature` object, nullable: Maximum bulkhead temperature requirement
    - `value` number
    - `unit` string
  - `commodity` string, nullable: Commodity description
  - `commodityItems` CommodityItem[], nullable: List of commodity items
    - `quantity` integer: Number of items
    - `description` string, nullable: Description of the commodity
    - `totalWeightLbs` number, nullable: Total weight in pounds
    - `lengthInches` integer, nullable
    - `widthInches` integer, nullable
    - `heightInches` integer, nullable
    - `freightClass` string, nullable
    - `nmfc` string, nullable
    - `density` number, nullable
    - `pickupSequence` integer, nullable: Sequence number of the pickup stop for this item
    - `deliverySequence` integer, nullable: Sequence number of the delivery stop for this item
  - `service` 'HOTSHOT' | 'PARTIAL' | 'STANDARD' | 'TIME_CRITICAL' | 'VOLUME' | 'null', nullable: Service type for the load
  - `highValueAmount` number, nullable: High value amount in USD
  - `targetRate` number, nullable: Target rate in USD
  - `maxRate` number, nullable: Maximum bid amount in USD
  - `totalRate` number, nullable: Total rate for the load in USD
  - `totalCarrierRate` number, nullable: Total carrier rate in USD
  - `bidExpiration` string, date-time, nullable: Bid expiration time
  - `bidCustomValues` object[]: Custom bid values
    - `name` string
    - `value` string
  - `isPostedToDAT` boolean, 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).
  - `isPostedToHighway` boolean, nullable: Indicates whether the load has been posted to Highway
  - `customerName` string, nullable: Primary customer name
  - `customerId` string, nullable: Primary customer identifier
  - `referenceNumbers` object[], required: Reference numbers associated with the load
    - `name` 'BILLED_DATE' | 'BOOKING_NUMBER' | 'BOL_NUMBER' | 'CONSIGNEE_NUMBER' | 'CONSIGNEE_REF_NUMBER' | 'CONTAINER_NUMBER' | 'CONTROL_NUMBER' | 'CUSTOMER_REF_NUMBER' | 'DAT_POSTING_ID' | 'PICKUP_NUMBER' | 'PO_NUMBER' | 'POSTING_GROUP_ID' | 'PRO_NUMBER' | 'RELEASED_DATE' | 'REQUIRED_DOCS' | 'SHIPMENT_NUMBER' | 'SHIPPER_NUMBER' | 'TMS_LOAD_STATUS' | 'TMS_SHIPMENT_STATUS' | 'TRAILER_NUMBER' | 'TRUCK_NUMBER' | 'OTHER', required
    - `value` string, required
  - `trackingEvents` TrackingEvent[], required: Tracking events for the load
    - `nextSequence` integer: Sequence number of the stop `nextEtaUtc` applies to, matching `LoadRouteStop.sequence`.
    - `nextEtaUtc` string, date-time: Next estimated arrival time as a UTC ISO 8601 timestamp with an offset (e.g. ending in `Z`, as in `2026-09-12T08:01:05Z`). When `isLocalTime` is true, send a naive local timestamp with no offset instead (e.g. `2026-09-12T03:01:05`).
    - `eventType` 'DELAYED' | 'INFO' | 'PICKED_UP' | 'PING' | 'COVERED' | 'DISPATCHED', required: Type of tracking event.
    - `eventSource` '4KITES' | 'CARRIER_API' | 'HIGHWAY' | 'MACROPOINT' | 'P44' | 'PHONE_EMAIL' | 'SMC3' | 'TEXT' | 'TMS' | 'TRUCKER_TOOLS' | 'OTHER', required: How the tracking data was obtained.
    - `eventUtc` string, date-time, required: Event time as a UTC ISO 8601 timestamp with an offset (e.g. ending in `Z`, as in `2026-09-11T23:00:25Z`). When `isLocalTime` is true, send a naive local timestamp with no offset instead (e.g. `2026-09-11T18:00:25`).
    - `isLocalTime` boolean: When true, `eventUtc` and `nextEtaUtc` (if present) are treated as naive local times and converted to UTC using the timezone resolved from `latitude`/`longitude`, `postalCode`, or `city`/`stateOrProvince` (in that priority order); `country` (defaults to `US`) helps disambiguate the `postalCode` lookup. One of `latitude`/`longitude`, `postalCode`, or `city`/`stateOrProvince` must be present when `isLocalTime` is true.
    - `city` string: City closest to the event location.
    - `country` string: Country of the event location, as an ISO 3166-1 alpha-2 code. Used to disambiguate the `postalCode` lookup when `isLocalTime` is true; defaults to `US` when omitted. Only `US`, `CA`, and `MX` are currently supported for this lookup — any other value falls back to `US`.
    - `stateOrProvince` string: State or province closest to the event location.
    - `postalCode` string
    - `latitude` number
    - `longitude` number
    - `temperatureF` number: Temperature in Fahrenheit, if reported by the source.
    - `notes` string: Free-text context from the carrier communication.
    - `dispatcher` TrackingEventContact: Contact information for a person associated with a tracking event.
      - `id` string: Identifier of the contact in the TMS system.
      - `name` string: Full name of the contact.
      - `phone` string: Phone number in E.164 format (e.g., +12081234567) or common local format. Supports US, CA, MX, PH.
      - `phoneExtension` string: Phone number extension (numeric only).
      - `email` string: Email address of the contact.
    - `driver` TrackingEventContact: Contact information for a person associated with a tracking event.
      - `id` string: Identifier of the contact in the TMS system.
      - `name` string: Full name of the contact.
      - `phone` string: Phone number in E.164 format (e.g., +12081234567) or common local format. Supports US, CA, MX, PH.
      - `phoneExtension` string: Phone number extension (numeric only).
      - `email` string: Email address of the contact.
  - `externalTrackingStatus` object, nullable: External tracking status information
    - `source` 'MACROPOINT' | 'P44' | 'OTHER', required: The source system or service providing the tracking status
    - `message` string, required: Human-readable message describing the current tracking status
    - `code` 'READY' | 'WAITING' | 'FAILED' | 'COMPLETED', required: Status code indicating the current state of external tracking
    - `updatedAt` string, date-time, required: The timestamp when the tracking status was last updated in UTC, or with a specific timezone offset
  - `notes` object[], required: Operational notes about the load. Provides context for tracking and operations.
    - `timestamp` string, date-time
    - `text` string: Content of the note
    - `author` string: Author of the note
  - `customers` LoadCustomer[], required: Customers associated with the load
    - `name` string, required: Customer name
    - `customerId` string, nullable: Customer identifier
    - `customerContact` string, nullable: Customer contact information
  - `loadShipments` LoadShipment[], required: Shipments associated with the load
    - `loadShipmentRef` string, required: Unique identifier for the load shipment.
    - `loadShipmentInternalRef` string: Optional internal load shipment ID in the TMS. Use loadShipmentRef as the main ID.
    - `shipmentRef` string
    - `status` 'DRAFT' | 'CUSTOMER_CONFIRMED' | 'COVERED' | 'DISPATCHED' | 'AT_PICKUP' | 'IN_TRANSIT' | 'AT_DELIVERY' | 'DELIVERED' | 'POD_COLLECTED' | 'PAID' | 'CANCELED' | 'ERROR' | 'ARCHIVED': 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](/guide/start-developing/load-status-validation).
    - `referenceNumbers` object[]
      - `name` 'BILLED_DATE' | 'BOOKING_NUMBER' | 'BOL_NUMBER' | 'CONSIGNEE_NUMBER' | 'CONSIGNEE_REF_NUMBER' | 'CONTAINER_NUMBER' | 'CONTROL_NUMBER' | 'CUSTOMER_REF_NUMBER' | 'DAT_POSTING_ID' | 'PICKUP_NUMBER' | 'PO_NUMBER' | 'POSTING_GROUP_ID' | 'PRO_NUMBER' | 'RELEASED_DATE' | 'REQUIRED_DOCS' | 'SHIPMENT_NUMBER' | 'SHIPPER_NUMBER' | 'TMS_LOAD_STATUS' | 'TMS_SHIPMENT_STATUS' | 'TRAILER_NUMBER' | 'TRUCK_NUMBER' | 'OTHER', required
      - `value` string, required
    - `accessorials` AccessorialsEnum[]
    - `notes` object[]
      - `timestamp` string, date-time, required
      - `text` string, required: Content of the note
      - `author` string, required: Author of the note
    - `route` object: A stop on the load's route. `expectedArrivalWindowStart` and `expectedArrivalWindowEnd` are the only fields whose requirement depends on the load's status: they are optional while the load is a `DRAFT`, and required on every stop once the load reaches `CUSTOMER_CONFIRMED` or a later lifecycle status. See [Load Status Validation](/guide/start-developing/load-status-validation).
      - `loadSequence` integer, required: The sequence number of the stop in overall load route.
      - `sequence` integer, required: The sequence number of the stop in the route. Number should start at 1 increase by 1 for the following stop.
      - `externalId` string: Optional external ID for the stop. This is used to link the stop to an external system.
      - `facilityCode` string, nullable: Identifier of the facility where the stop takes place, matching the facility's external ID in your TMS. Stored as provided and not checked against a known facility, so an unrecognized code is accepted rather than rejected.
      - `stopActivity` 'PICKUP' | 'DELIVERY', required
      - `address` object, required
        - `company` string
        - `locationName` string
        - `street1` string, required
        - `street2` string
        - `city` string, required
        - `stateOrProvince` string, required
        - `postalCode` string, required
        - `country` string, required: Must be 2-letter ISO country code as listed here: https://www.iban.com/country-codes
      - `notes` string: Optional notes for the stop.
      - `expectedArrivalWindowStart` string, date-time: Expected arrival window start time in UTC, or with a specific timezone offset. Optional at `DRAFT`; required once the load reaches `CUSTOMER_CONFIRMED` or later. Must be at or before `expectedArrivalWindowEnd` whenever both are present.
      - `expectedArrivalWindowEnd` string, date-time: Expected arrival window end time in UTC, or with a specified timezone offset. Optional at `DRAFT`; required once the load reaches `CUSTOMER_CONFIRMED` or later.
      - `actualArrivalTime` string, date-time: Actual arrival time in UTC, or with a specific timezone offset
      - `actualCompletionTime` string, date-time: Actual completion time in UTC, or with a specific timezone offset
      - `expectedDropWindowStart` string, date-time: Expected window start time for drop trailers in UTC, or with a specific timezone offset
      - `expectedDropWindowEnd` string, date-time: Expected window end time for drop trailers in UTC, or with a specific timezone offset
      - `mustArriveByDate` string, date-time: The date and time by which the carrier must arrive at this stop, in UTC or with a specific timezone offset
      - `isLocalTime` boolean: When true, route times are in local time instead of UTC. When this is true, omit the Z suffix or timezone offset from all route time strings. Example: 2017-07-21T17:32:28
      - `schedulingType` 'APPT' | 'FCFS': Scheduling type for the stop. - APPT (Appointment) indicates the stop operates on an appointment basis. - FCFS (First Come First Serve) indicates the stop accepts arrivals on a first-come-first-serve basis.
      - `handlingType` 'DT' | 'L': Handling type for the stop. - DT (Drop Trailer) indicates the location supports drop-trailer operations. - L (Live) indicates live loading or unloading where the driver stays with the trailer.
      - `customData` StopCustomData, nullable: Optional client-specific metadata for this stop. 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 2,000 characters. Use this field to attach stop-specific references such as pickup numbers, BOL numbers, or PO numbers to individual stops rather than flattening them into load-level `customData`. On update, sending this field replaces the stored value for that stop. Because routes are replaced wholesale on every write, omitting `customData` from a stop clears it to `null`. Send `null` explicitly to clear a previously stored value.
    - `items` LoadItem[]
      - `quantity` integer, required: Item quantity. Required if item is provided.
      - `packagingUnit` LoadItemUnit
        - `unitType` 'PALLET' | 'PIECE' | 'CARTON' | 'TOTE' | 'SKID' | 'CRATE' | 'BOX' | 'DRUM' | 'CASE' | 'BUNDLE' | 'OTHER' | 'FLOOR_LOADED' | 'ROLL' | 'SHEET', required
        - `quantity` number, required: Quantity of this unit type.
      - `handlingUnit` LoadItemUnit
        - `unitType` 'PALLET' | 'PIECE' | 'CARTON' | 'TOTE' | 'SKID' | 'CRATE' | 'BOX' | 'DRUM' | 'CASE' | 'BUNDLE' | 'OTHER' | 'FLOOR_LOADED' | 'ROLL' | 'SHEET', required
        - `quantity` number, required: Quantity of this unit type.
      - `description` string: Commodity description for this item. Augment's AI agent uses this value verbatim when speaking with carriers.
      - `totalWeightLbs` number, required: Required if item is provided
      - `lengthInches` integer
      - `widthInches` integer
      - `heightInches` integer
      - `freightClass` '50' | '55' | '60' | '65' | '70' | '77.5' | '85' | '92.5' | '100' | '110' | '125' | '150' | '175' | '200' | '250' | '300' | '400' | '500'
      - `nmfc` string
      - `density` number
      - `pickupSequence` integer
      - `deliverySequence` integer
    - `minTemperatureF` number: Minimum temperature requirement in Fahrenheit
    - `maxTemperatureF` number: Maximum temperature requirement in Fahrenheit
    - `service` 'HOTSHOT' | 'PARTIAL' | 'STANDARD' | 'TIME_CRITICAL' | 'VOLUME'
    - `customer` Customer
      - `customerId` string
      - `name` string, required
  - `podCollectionStatus` 'NOT_STARTED' | 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: POD collection workflow status
  - `lastLocationUpdate` string, date-time, nullable: Timestamp of the last location update
  - `groupExternalId` string, nullable: The external identifier for the group this load belongs to.
  - `createdAt` string, date-time, required: Timestamp when the load was created
  - `updatedAt` string, date-time, required: Timestamp when the load was last updated

## Other responses

- `400`: Bad request - loadNumber query parameter is required
- `401`: Unauthorized
- `404`: Load not found

---

[API](https://skmtc.dev/goaugment/apis/augment-api.md) - [All operations](https://skmtc.dev/goaugment/apis/augment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/augment-api/revisions/b61097634d79?raw)