---
title: "Submit a load request"
method: POST
path: "/api/v1/Loads"
tags: ["Shipper - Shipment APIs"]
---

# Submit a load request

`POST /api/v1/Loads`

Allows Shippers to submit load build requests with relevant load information, including a Spot Quote ID. \
*Note: Including a Spot Quote ID is currently unsupported in Europe.*

## Request body

- CoyoteSystemsExternalApiContractsModelsLoadBuildingLoad — Load information
  - `customer` CoyoteSystemsExternalApiContractsModelsLoadBuildingCustomer — Customer information
    - `referenceNumbers` CoyoteSystemsExternalApiContractsModelsLoadBuildingReferenceNumber[], nullable — List of reference numbers
      - `referenceNumberType` 'Reference' | 'OrderNumber' | 'BillOfLading' | 'CommercialInvoice' | 'MasterBOLNumber' | 'PoNumber' | 'ProNumber' | 'ShipmentNumber' — Multiple number types
      - `referenceNumberValue` string, nullable — Reference number value. Can be alphanumeric (50 characters limit)
    - `customerId` integer — Customer Id
  - `loadDetail` CoyoteSystemsExternalApiContractsModelsLoadBuildingLoadDetail, required — Load Details
    - `mode` 'TL' | 'LTL' | 'IMDL', required — Load Modes
    - `equipmentType` 'V' | 'R', required — Equipment Type
    - `equipmentLength` integer, required — Equipment length
    - `requirements` CoyoteSystemsExternalApiContractsModelsLoadBuildingLoadRequirement[], nullable — Load requirements
      - `requirementType` 'Guaranteed' | 'Team' | 'HazmatEndorsement' | 'TankerEndorsement' | 'Hvhr' | 'HvhrPlus' | 'ProtectFromFreeze' | 'PartialLoad' | 'DoubleBlind' | 'DisasterRelief' | 'TradeShow' | 'TechTrackingRequired' | 'Fast' | 'PipOrPep' | 'Neec' | 'BondedCarrier' | 'OverDimension' | 'Ctpat' | 'IntraMexico' | 'CrossBorderMexico' | 'BorderCrossingByCustomer' | 'BorderCrossingByCoyote' | 'FdaClearanceRequired' | 'TransloadByCustomer' | 'TransloadByCoyote' | 'SecondaryBorderInspection' | 'RepairReceiptRequiredForBreakdowns' | 'Haccp' | 'Seal' | 'NoCameraPhonePhotosOfPaperwork' | 'MustBeDedicatedTrailer' | 'ThroughTrailerOnly' | 'NoSubcontracting' | 'NoTransitViaSwitzerland' | 'SecureParkingInTransit' | 'ThermographPrintout' | 'TransitViaEurotunnel' — Load requirement type
      - `requirementValue` string, nullable — Requirement value
    - `equipmentRequirements` CoyoteSystemsExternalApiContractsModelsLoadBuildingLoadEquipmentRequirement[], nullable — Load equipment requirements
      - `requirementType` 'FoodGrade' | 'PaperGrade' | 'LiftGate' | 'PalletJack' | 'AirRide' | 'TrailerXYearsOrNewer' | 'XLoadLocks' | 'XLoadBars' | 'XLoadStraps' | 'ETrack' | 'Chains' | 'NoRollDoor' | 'NoReefer' | 'NoLiftGate' | 'DoubleTrailer' | 'TripleTrailer' | 'LoadOutTrailer' | 'TowAway' | 'LightweightEquipment' | 'TandemSlide' | 'DownloadableReefer' | 'SpaceSaverReefer' | 'TranslucentTop' | 'Duraplate' | 'VentedVan' | 'FunctionalAirChute' | 'RollDoorAllowed' | 'XSideboards' | 'ScaleUpToXPounds' | 'ScaleUpToXKilograms' | 'TrailerMustHaveAllWoodFloors' | 'XlCode' — Load Equipment requirement types
      - `requirementValue` string, nullable — Requirement value
    - `stops` CoyoteSystemsExternalApiContractsModelsLoadBuildingLoadStop[], required — List of load stops
      - `sequence` integer, required — Stop sequence
      - `stopType` 'Pickup' | 'Delivery', required — Stop Types
      - `facility` CoyoteSystemsExternalApiContractsModelsLoadBuildingFacility, required — Facility
        - `name` string, required — Name of the facility (It must be 50 characters or less.)
        - `address` CoyoteSystemsExternalApiContractsModelsLoadBuildingTrackingAddress, required — Address
          - `line1` string, required — Line 1 (It must be 3-50 characters.)
          - `line2` string, nullable — Line 2 (It must be 50 characters or less.)
          - `line3` string, nullable — Line 3
          - `postalCode` string, required — Postal Code
          - `cityName` string, required — City Name
          - `stateProvinceCode` string, required — State or Province Code
          - `countryCode` string, required — Country Code
        - `geoCoordinates` CoyoteSystemsExternalApiContractsModelsLoadBuildingGeoCoordinates — GeoCoordinates
          - `latitude` number, double, required — Latitude
          - `longitude` number, double, required — Longitude
        - `facilityContact` CoyoteSystemsExternalApiContractsModelsLoadBuildingContact — Contact details
          - `name` string, nullable — Contact Name (It must be 50 characters or less.)
          - `phoneNumberCountryCode` string, nullable — Phone number country code
          - `phoneNumber` string, nullable — Phone number
          - `phoneNumberExtension` string, nullable — Phone number extension
          - `email` string, nullable — Contact email address
      - `stopRequirements` CoyoteSystemsExternalApiContractsModelsLoadBuildingLoadStopRequirement[], nullable — Stop requirements
        - `requirementType` 'DropTrailerRequired' | 'DropAndHook' | 'DropTrailerAllowXHoursToUnload' | 'PreloadDropTrailerXHoursInAdvance' | 'Blind' | 'Government' | 'TWIC' | 'EscortOrTWICRequired' | 'UIIA' | 'LiquorPermit' | 'StrictAppt' | 'NoWorkIns' | 'NoEarlyDeliveries' | 'NoSameDayReschedules' | 'XRescheduleFee' | 'XLateFee' | 'ScaleEmpty' | 'ScaleHeavy' | 'XTankOfFuelAtShipper' | 'LoadedToLegalWeight' | 'NotAllowedOnDock' | 'MustCheckinAsCoyote' | 'NoLoadLocksOrStraps' | 'MustSecureLoad' | 'MustProvideAndApplySeal' | 'ExitPass' | 'EnglishSpeaking' | 'SpanishSpeaking' | 'USCitizen' | 'ValidUSCommercialDriversLicenseHardcopy' | 'OnsiteParkingAvailable' | 'OvernightParkingAvailable' | 'LegalScaleOnSite' | 'SecureYard' | 'HardHat' | 'SafetyGlasses' | 'EarPlugs' | 'LongPants' | 'LongSleeves' | 'ClosedToeShoes' | 'SteelToeShoes' | 'SafetyVest' | 'NoTankTops' | 'NoAnimalsAllowed' | 'PayLumperWCashTCheck' | 'LumperReceiptRequired' | 'NeedCoyoteApprovalToUseLumperService' | 'PrepaidLumperService' | 'LumperReceiptRequiredWithinXHours' | 'TrailerDetentionAfterXDays' | 'NoTrailerDetentionOrLayover' | 'DetentionAuthFormRequired' | 'TrailerInspectionFormRequired' | 'Liftgate' | 'Residential' | 'LimitedAccess' | 'SortAndSegregate' | 'Inside' | 'Tradeshow' | 'UnpackDetrash' | 'ScaleTicketMustBeSubmittedWithPaperwork' | 'CarrierCannotContactFacility' | 'WeightIsApproximate' | 'PieceCountIsApproximate' | 'DriverBlockAndBraceProduct' | 'MustConfirmAllPosMatchRateCon' | 'CleanCriminalRecordRequired' | 'FacemaskRequired' | 'NoOnsiteParking' | 'NoOvernightParking' | 'SafetyVideoRequired' | 'WrittenSafetyTestRequired' | 'PaperworkRequiredWithinXHours' | 'CarrierNotifyBeforeArrival' | 'AppointmentRequired' | 'DoNotStack' | 'PalletExchange' | 'Fcfs' — Load stop requirements
        - `requirementValue` string, nullable — Stop requirement value
      - `openDateTimeUtc` string, date-time, nullable — Facility open date/time in UTC
      - `closeDateTimeUtc` string, date-time, nullable — Facility close date/time in UTC
      - `appointmentStartDateTimeUtc` string, date-time, nullable — Appointment open date/time in UTC
      - `appointmentEndDateTimeUtc` string, date-time, nullable — Appointment close date/time in UTC
      - `referenceNumbers` string[], nullable — Reference numbers
      - `stopNotes` string, nullable — Stop notes - special instructions relevant to stop (2500 characters limit)
    - `commodities` CoyoteSystemsExternalApiContractsModelsLoadBuildingLoadCommodity[], required — List of commodities
      - `description` string, required — Item Description (Description must be 100 characters or less.)
      - `poNumber` string, nullable — PO Number
      - `packagingType` 'NotApplicable' | 'Case' | 'Roll' | 'Box' | 'Sack' | 'Bale' | 'Carton' | 'Coil' | 'Drum' | 'ToteBin' | 'Bag' | 'Bundle' | 'Bulk' | 'DryBulk' | 'LiquidBulk' | 'Barge' | 'Barrel' | 'BasketOrHamper' | 'Beam' | 'Bin' | 'Bobbin' | 'Bottle' | 'BoxWithInnerContainer' | 'Bucket' | 'BulkBag' | 'Cabinet' | 'Cage' | 'Can' | 'CanCase' | 'CarloadRail' | 'Carboy' | 'Cask' | 'Chest' | 'Container' | 'ContainersOfBulkCargo' | 'Core' | 'Cradle' | 'Crate' | 'Cube' | 'Cylinder' | 'DoubleLengthRack' | 'DoubleLengthSkid' | 'DoubleLengthToteBin' | 'DuffleBag' | 'EngineContainer' | 'Envelope' | 'Firkin' | 'Flask' | 'FloBin' | 'ForwardReel' | 'Frame' | 'GarmentsOnHangers' | 'HalfStandardRack' | 'HalfStandardToteBin' | 'Hamper' | 'Jar' | 'Jug' | 'Keg' | 'Kit' | 'KnockdownRack' | 'KnockdownToteBin' | 'Lifts' | 'LinerBagDry' | 'LinerBagLiquid' | 'Loose' | 'Lug' | 'MilitaryVan' | 'MixedTypePack' | 'MultirollPack' | 'MultiwallContainerSecuredToPallet' | 'Noil' | 'OnHangerOrRackInboxes' | 'Overwrap' | 'Package' | 'Pail' | 'Pallet' | 'Pieces' | 'Pims' | 'PipeRack' | 'Platform' | 'PrivateVehicle' | 'Rack' | 'Reel' | 'Skid' | 'Sleeve' | 'SlipSheet' | 'Spool' | 'Tank' | 'ToteCan' | 'Tray' | 'TriwallBox' | 'Truck' | 'Tub' | 'Tube' | 'Unit' | 'VanPack' | 'IntermediateBulkContainers', required — Packaging types
      - `quantity` integer, required — Number of units
      - `palletCount` integer — Number of pallets relevant to commodity item **Required for LTL**
      - `weightUnit` 'Pounds' — Weight Units
      - `weight` number, double, required — Pallet weight in lbs(default) if not specified **Required for LTL**
      - `lengthUnit` 'Inches' | 'Meters' | 'Centimeters' | 'Millimeters' | 'Feet' — Length Units
      - `length` number, double — Pallet length in inches **Required for LTL**
      - `height` number, double — Pallet height in inches **Required for LTL**
      - `width` number, double — Pallet width in inches **Required for LTL**
      - `freightClass` 'Undefined' | 'N50' | 'N55' | 'N60' | 'N65' | 'N70' | 'N77PT5' | 'N85' | 'N92PT5' | 'N100' | 'N110' | 'N125' | 'N150' | 'N175' | 'N200' | 'N250' | 'N300' | 'N400' | 'N500' — FreightClass
      - `nmfcNumber` integer, nullable — NMFC Number
      - `nmfcSubNumber` integer, nullable — NMFC Sub number
      - `cargoValue` number, double, required — Cargo value
      - `stackable` boolean — Stackable
      - `temperatureUnit` 'Fahrenheit' | 'Celsius' — Temperature Units
      - `temperatureSetting` 'Continuous' | 'Cycle' — Temperature settings
      - `preCoolTemperature` number, double, nullable — PreCool temperature if required
      - `minimumTemperature` number, double, nullable — Minimum temperature setting
      - `maximumTemperature` number, double, nullable — Maximum temperature setting
      - `pickUpStopNumber` integer — Pick up stop number for commodity
      - `deliveryStopNumber` integer — Delivery stop number for commodity
      - `hazMatProperties` CoyoteSystemsExternalApiContractsModelsLoadBuildingHazMatProperties — HazMat Properties
        - `hazMat` boolean — HazMat
        - `hazMatClass` 'N3' | 'N8' | 'N9' | 'NotApplicable' | 'N2PT1' | 'N2PT2' | 'N4PT1' | 'N4PT2' | 'N5PT1' | 'N6PT1P2' | 'N6PT1P3' | 'N1PT4' | 'N1PT5' | 'N1PT6' — Hazmat class
        - `phoneNumber` string, nullable — PhoneNumber
    - `spotQuoteId` string, nullable — Spot Quote ID retrieved from Spot Quote requests API. For Truck Loads(TL) use the SpotQuoteId returned in TL Spot Quote request. For Less Than Truck Loads(LTL) use the CarrierQuoteId returned in LTL Spot Quote request.

## Response `200`

Load request sent successfully

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/coyote/apis/coyotego-api.md) · [All operations](https://skmtc.dev/coyote/apis/coyotego-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coyote/coyotego-api/revisions/3229e1a057a2/schema)