---
title: "Search available loads"
method: POST
path: "/api/v1/AvailableLoads/search"
tags: ["Carrier - Available Load APIs"]
---

# Search available loads

`POST /api/v1/AvailableLoads/search`

Allows Carriers to search for available loads with a set of query inputs. Coyote will return the list of all available loads that match the inputs provided in the request.

## Query parameters

- `page` integer — Requested page
- `pageSize` integer — Requested page size

## Request body

- CoyoteSystemsExternalApiContractsModelsAvailableLoadsAvailableLoadsRequest — Request object to fetch available loads
  - `origin` CoyoteSystemsExternalApiContractsModelsAvailableLoadsLoadStopLocationInfo, required — Defines the load stop location details for request
    - `location` CoyoteSystemsExternalApiContractsModelsAvailableLoadsGeoLocation — Geo location
      - `latitude` number, double, nullable — Latitude
      - `longitude` number, double, nullable — Longitude
    - `deadheadRadius` CoyoteSystemsExternalApiContractsModelsAvailableLoadsRadius — Defines radius
      - `value` integer, nullable — Value
      - `unit` 'Miles' | 'Kilometers' — Distance Unit
    - `appointment` CoyoteSystemsExternalApiContractsModelsAvailableLoadsAppointmentDate — Appointment date of stop
      - `appointmentStartDateTime` string, date-time, nullable — Appointment start date and time
      - `appointmentEndDateTime` string, date-time, nullable — Appointment end date and time
  - `destination` CoyoteSystemsExternalApiContractsModelsAvailableLoadsLoadStopLocationInfo — Defines the load stop location details for request
    - `location` CoyoteSystemsExternalApiContractsModelsAvailableLoadsGeoLocation — Geo location
      - `latitude` number, double, nullable — Latitude
      - `longitude` number, double, nullable — Longitude
    - `deadheadRadius` CoyoteSystemsExternalApiContractsModelsAvailableLoadsRadius — Defines radius
      - `value` integer, nullable — Value
      - `unit` 'Miles' | 'Kilometers' — Distance Unit
    - `appointment` CoyoteSystemsExternalApiContractsModelsAvailableLoadsAppointmentDate — Appointment date of stop
      - `appointmentStartDateTime` string, date-time, nullable — Appointment start date and time
      - `appointmentEndDateTime` string, date-time, nullable — Appointment end date and time
  - `equipmentType` 'V' | 'R' | 'F' | 'VR' | 'C' | 'SD' | 'DF' | 'DD' | 'SS' | 'FT' | 'E' | 'T' | 'B' | 'Z' | 'M' | 'Q' | 'P' | 'CNRU' | 'CPPU' | 'CSXU' | 'EMHU' | 'EMPU' | 'EMWU' | 'EPTY' | 'PACU' | 'W' | 'G' | 'K' | 'DR' | 'H' | 'FWS' | 'BT' | 'ZS' | 'XM' | 'MV' | 'MF' | 'FM' | 'DV' | 'LALL' | 'SDL' | 'A' | 'BL' | 'RC' | 'HS' | 'GM' | 'GS' | 'FS' | 'SDS' | 'RTC' | 'RTB' | 'WFB' | 'PO' | 'DDT' | 'DDB' | 'DDF' | 'SFB' | 'SFC' | 'RBC' | 'FB' | 'FBT' | 'FBX' | 'SKC' | 'LL' | 'LLS' | 'LLX' | 'TKC' | 'TKF' | 'IM' | 'IMF', required — Equipment Type
  - `mode` 'TL_LTL' | 'TL' | 'LTL', required

## Response `200`

Loads successfully retrieved and returned

- CoyoteSystemsExternalApiContractsModelsAvailableLoadsPagedAvailableLoads — Defines the paged available loads
  - `loads` CoyoteSystemsExternalApiContractsModelsAvailableLoadsAvailableLoad[], nullable — List of available loads
    - `loadId` integer, required — Available load ID
    - `orderNumber` string, nullable — Order number
    - `loadDetails` CoyoteSystemsExternalApiContractsModelsAvailableLoadsLoadDetails, required — Load details
      - `rate` CoyoteSystemsExternalApiContractsModelsAvailableLoadsRate, required — Defines the load rate
        - `value` number, double, required — Load rate
        - `currencyType` 'Undefined' | 'USD' | 'CAD' | 'MXN' | 'ARS' | 'BRL' | 'CLP' | 'COP' | 'VEF' | 'EUR' | 'GBP' | 'HUF' | 'PLN', required — Currency Type
      - `mode` 'TL' | 'LTL' | 'IMDL', required — Load Modes
      - `equipment` CoyoteSystemsExternalApiContractsModelsAvailableLoadsEquipmentDetails, required — Equipment details
        - `equipmentHeight` CoyoteSystemsExternalApiContractsModelsAvailableLoadsDimension, required — Defines the Dimension
          - `value` number, double, required — Dimension value
          - `unit` 'Undefined' | 'Inches' | 'Meters' | 'Centimeters' | 'Millimeters' | 'Feet', required — Dimension Units
        - `equipmentLength` CoyoteSystemsExternalApiContractsModelsAvailableLoadsDimension, required — Defines the Dimension
          - `value` number, double, required — Dimension value
          - `unit` 'Undefined' | 'Inches' | 'Meters' | 'Centimeters' | 'Millimeters' | 'Feet', required — Dimension Units
        - `equipmentType` string, required — Equipment type
        - `equipmentWidth` CoyoteSystemsExternalApiContractsModelsAvailableLoadsDimension, required — Defines the Dimension
          - `value` number, double, required — Dimension value
          - `unit` 'Undefined' | 'Inches' | 'Meters' | 'Centimeters' | 'Millimeters' | 'Feet', required — Dimension Units
        - `equipmentAttributes` CoyoteSystemsExternalApiContractsModelsAvailableLoadsEquipmentAttributes, required — Equipment attributes
          - `foodGrade` boolean — Is food grade
          - `paperGrade` boolean — Is paper grade
          - `preCoolRequired` boolean — Is pre-cool required
          - `liftGate` boolean — Is lift gate
          - `palletJack` boolean — Is pallet jack
          - `airRide` boolean — Is air ride
          - `trailerXYearsOrNewer` integer — Trailer X years or newer
          - `xLoadLocks` integer — X load locks
          - `xLoadBars` integer — X load bars
          - `xLoadStraps` integer — X load straps
          - `xSideboards` integer — X sideboards
          - `eTrack` boolean — Is ETrack
          - `chains` boolean — Is chains
          - `noRollDoor` boolean — Is no roll door
          - `rollDoorAllowed` boolean — Is roll door allowed
          - `noReefer` boolean — Is no reefer
          - `noLiftGate` boolean — Is no lift gate
          - `doubleTrailer` boolean — Is double trailer
          - `tripleTrailer` boolean — Is triple trailer
          - `loadOutTrailer` boolean — Is load out trailer
          - `towAway` boolean — Is tow away
          - `lightweightEquipment` boolean — Is lightweight equipment
          - `scaleUpToXPounds` integer — Scale up to X pounds
          - `scaleUpToXKilograms` integer — Scale up to X kilograms
          - `tandemSlide` boolean — Is tandem slide
          - `downloadableReefer` boolean — Is downloadable reefer
          - `spaceSaverReefer` boolean — Is space saver reefer
          - `translucentTop` boolean — Is translucent top
          - `duraplate` boolean — Is duraplate
          - `ventedVan` boolean — Is vented van
          - `functionalAirChute` boolean — Is functional air chute
          - `trailerMustHaveAllWoodFloors` boolean — Is trailer must have allWood floors
          - `xlCode` boolean — Is Xl code
        - `genericAttributes` CoyoteSystemsExternalApiContractsModelsAvailableLoadsGenericAttributeItem[], nullable — Collection of generic attributes
          - `key` string, required — Unique name
          - `displayText` string, required — Display name
      - `loadDistance` CoyoteSystemsExternalApiContractsModelsAvailableLoadsDistance, required — Distance to Next Stop
        - `value` number, double, required — Value
        - `unit` 'Miles' | 'Kilometers', required — Distance Unit
      - `weight` CoyoteSystemsExternalApiContractsModelsAvailableLoadsWeight, required — Defines the weight
        - `value` number, double, required — Weight value
        - `unit` 'Undefined' | 'Pounds' | 'Kilograms' | 'Tons' | 'MetricTons', required — Weight Units
      - `temperatureSettings` CoyoteSystemsExternalApiContractsModelsAvailableLoadsTemperatureSettings, required — Defines the temperature settings of load
        - `preCoolTemperature` CoyoteSystemsExternalApiContractsModelsAvailableLoadsTemperature — Defines the temperature details
          - `value` number, double, required — Temperature value.
          - `unit` 'Fahrenheit' | 'Celsius', required — Temperature Units
        - `maximumTemperature` CoyoteSystemsExternalApiContractsModelsAvailableLoadsTemperature — Defines the temperature details
          - `value` number, double, required — Temperature value.
          - `unit` 'Fahrenheit' | 'Celsius', required — Temperature Units
        - `minimumTemperature` CoyoteSystemsExternalApiContractsModelsAvailableLoadsTemperature — Defines the temperature details
          - `value` number, double, required — Temperature value.
          - `unit` 'Fahrenheit' | 'Celsius', required — Temperature Units
      - `loadAttributes` CoyoteSystemsExternalApiContractsModelsAvailableLoadsLoadAttributes, required — Load attributes
        - `airRide` boolean, required — Is load airride
        - `blind` boolean, required — Is load blind
        - `bondedCarrier` boolean, required — Is bonded carrier
        - `borderCrossingByCoyote` boolean, required — Is border crossing by coyote
        - `borderCrossingByCustomer` boolean, required — Is border crossing by customer
        - `coyoteGo` boolean, required — Is CoyoteGo
        - `crossBorderMexico` boolean, required — Is cross border Mexico
        - `ctpat` boolean, required — Is CTPAT
        - `disasterRelief` boolean, required — Is disaster relief
        - `doubleBlind` boolean, required — Is double blind
        - `doubleTrailer` boolean, required — Is double trailer load
        - `drayage` boolean, required — Is drayage
        - `duraplate` boolean, required — Is duraplate
        - `englishSpeaking` boolean, required — Is English speaking
        - `exitPass` boolean, required — Is exit pass
        - `fast` boolean, required — Fast
        - `fdaClearanceRequired` boolean, required — Is FDA clearance required
        - `floodRelief` boolean, required — Is flood relief
        - `govt` boolean, required — Govt
        - `guaranteed` boolean, required — Guaranteed
        - `haccp` boolean, required — HACCP
        - `hazmatEndorsement` boolean, required — Hazmat Endorsement
        - `hvhr` boolean, required — Is HVHR
        - `hvhrPlus` boolean, required — HVHR plus
        - `intraMexico` boolean, required — Is Intra Mexico
        - `liquor` boolean, required — Is liquor
        - `neec` boolean, required — Is NEEC
        - `noCameraPhonePhotosOfPaperwork` boolean, required — No camera phone photos of paperwork
        - `overDimension` boolean, required — Is over dimension
        - `palletJack` boolean, required — Is pallet jack
        - `partialLoad` boolean, required — Is partial Load
        - `pipOrPep` boolean, required — Is PIP or PEP
        - `powerOnly` boolean, required — Is power only load
        - `ppe` boolean, required — Is PPE
        - `protectFromFreeze` boolean, required — Whether protect from freeze
        - `repairReceiptRequiredForBreakdowns` boolean, required — Whether repair receipt required for breakdowns
        - `seal` boolean, required — Is seal
        - `secondaryBorderInspection` boolean, required — Is secondary border inspection
        - `tankerEndorsement` boolean, required — Is tanker endorsement
        - `tcr` boolean, required — Is TCR
        - `team` boolean, required — Is team
        - `techTrackingRequired` boolean, required — Whether tech tracking required
        - `tradeShow` boolean, required — Is trade show
        - `trailerControl` boolean, required — Is trailer control
        - `transloadByCoyote` boolean, required — Is transload by coyote
        - `transloadByCustomer` boolean, required — Is transload by customer
        - `tripleTrailer` boolean, required — Is triple trailer
        - `twic` boolean, required — Is TWIC
        - `uiia` boolean, required — Is UIIA
      - `genericAttributes` CoyoteSystemsExternalApiContractsModelsAvailableLoadsGenericAttributeItem[], nullable — Collection of generic attributes
        - `key` string, required — Unique name
        - `displayText` string, required — Display name
    - `stops` CoyoteSystemsExternalApiContractsModelsAvailableLoadsLoadStop[], required — Load stops information
      - `sequence` integer, required — Stop sequence
      - `stopType` 'None' | 'Pickup' | 'Delivery' | 'ContainerDepotOrigin' | 'ContainerDepotTermination' | 'OriginRamp' | 'DestinationRamp' | 'OriginPort' | 'DestinationPort' | 'OriginAirport' | 'DestinationAirport' | 'CrossDock', required — Stop Types
      - `facility` CoyoteSystemsExternalApiContractsModelsAvailableLoadsFacility, required — Facility
        - `name` string, required — Name
        - `address` CoyoteSystemsExternalApiContractsModelsAvailableLoadsTrackingAddress, required — Address
          - `line1` string, required — Line 1
          - `line2` string, nullable — Line 2
          - `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` CoyoteSystemsExternalApiContractsModelsAvailableLoadsGeoCoordinates, required — GeoCoordinates
          - `latitude` number, double, required — Latitude
          - `longitude` number, double, required — Longitude
        - `timeZoneOffset` SystemTimeSpan, required
          - `ticks` integer
          - `days` integer
          - `hours` integer
          - `milliseconds` integer
          - `minutes` integer
          - `seconds` integer
          - `totalDays` number, double
          - `totalHours` number, double
          - `totalMilliseconds` number, double
          - `totalMinutes` number, double
          - `totalSeconds` number, double
      - `appointment` CoyoteSystemsExternalApiContractsModelsAvailableLoadsAppointment, required — Appointment
        - `facilityOpenDateTimeUtc` string, date-time, nullable — Facility Open DateTime in Utc
        - `facilityCloseDateTimeUtc` string, date-time, nullable — Facility Close DateTime in Utc
        - `appointmentStartDateTimeUtc` string, date-time, nullable — Appointment Start DateTime in Utc
        - `appointmentEndDateTimeUtc` string, date-time, nullable — Appointment End DateTime in Utc
      - `stopDetails` CoyoteSystemsExternalApiContractsModelsAvailableLoadsStopDetails, required — Load stop details
        - `commodities` CoyoteSystemsExternalApiContractsModelsAvailableLoadsLoadCommodity[], required — List of stop commodities
          - `description` string, required — Description of load commodity
          - `weight` CoyoteSystemsExternalApiContractsModelsAvailableLoadsWeight, required — Defines the weight
            - `value` number, double, required — Weight value
            - `unit` 'Undefined' | 'Pounds' | 'Kilograms' | 'Tons' | 'MetricTons', required — Weight Units
        - `stopAttributes` CoyoteSystemsExternalApiContractsModelsAvailableLoadsLoadStopAttributes — Defines the Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.LoadStopAttributes.
          - `blind` boolean — Is blind
          - `closedToeShoes` boolean — Is closed toe shoes
          - `detentionAuthFormRequired` boolean — Is detention auth form required
          - `driverAssist` boolean — Whether driver assist
          - `dropAndHook` boolean — Is drop and hook
          - `dropTrailerAllowXHoursToUnload` integer — Allow hours to unload
          - `dropTrailerRequired` boolean — Is drop trailer required
          - `earPlugs` boolean — Ear plugs
          - `englishSpeaking` boolean — Is English speaking
          - `escortOrTwicRequired` boolean — Whether escort or twic Required
          - `exitPass` boolean — Exit pass
          - `government` boolean — Is government
          - `hardHat` boolean — Is hard hat
          - `inOutTimesWSignature` boolean — Are in out times with signature
          - `insideDelivery` boolean — Is inside delivery
          - `insidePickup` boolean — Is inside pickup
          - `legalScaleOnSite` boolean — Is legal scale on site
          - `liftgateDelivery` boolean — Is liftgate delivery
          - `liftgatePickup` boolean — Is liftgate pickup
          - `limitedAccessDeliveryAirport` boolean — Is limited access delivery airport
          - `limitedAccessDeliveryChurch` boolean — Is limited access delivery church
          - `limitedAccessDeliveryConstructionSite` boolean — Is limited access delivery construction site
          - `limitedAccessDeliveryFarm` boolean — Is limited access delivery farm
          - `limitedAccessDeliveryMilitaryBase` boolean — Is limited access delivery military base
          - `limitedAccessDeliveryMineSite` boolean — Is limited access delivery mine site
          - `limitedAccessDeliveryMiniStorage` boolean — Is limited access delivery mini storage
          - `limitedAccessDeliveryOther` boolean — Is limited access delivery other
          - `limitedAccessDeliveryPrison` boolean — Is limited access delivery prison
          - `limitedAccessDeliveryRemoteGovt` boolean — Is limited access delivery remote govt
          - `limitedAccessDeliverySchool` boolean — Is limited access delivery school
          - `limitedAccessPickupAirport` boolean — Is limited access pickup airport
          - `limitedAccessPickupChurch` boolean — Is limited access pickup church
          - `limitedAccessPickupConstructionSite` boolean — Is limited access pickup construction site
          - `limitedAccessPickupFarm` boolean — Is limited access pickup farm
          - `limitedAccessPickupMilitaryBase` boolean — Is limited access pickup military base
          - `limitedAccessPickupMineSite` boolean — Is limited access pickup mine site
          - `limitedAccessPickupMiniStorage` boolean — Is limited access pickup mini storage
          - `limitedAccessPickupOther` boolean — Is limited access pickup other
          - `limitedAccessPickupPrison` boolean — Is limited access pickup prison
          - `limitedAccessPickupRemoteGovt` boolean — Is limited access pickup remote govt
          - `limitedAccessPickupSchool` boolean — Is limited access pickup school
          - `liquorPermit` boolean — Is liquor permit
          - `loadedToLegalWeight` boolean — Is loaded to legal weight
          - `longPants` boolean — Is long pants
          - `longSleeves` boolean — Is long sleeves
          - `lumperReceiptRequired` boolean — Whether lumper receipt required
          - `mustCheckInAsCoyote` boolean — Must check in as Coyote
          - `mustProvideAndApplySeal` boolean — Whether must provide and apply seal
          - `mustSecureLoad` boolean — Whether must secure load
          - `needCoyoteApprovalToUseLumperService` boolean — Is Coyote approval needed to use lumper service
          - `noAnimals` boolean — Is no animals
          - `noDetention` boolean — Is no detention
          - `noEarlyDeliveries` boolean — Whether no early deliveries
          - `noLoadLocksOrStraps` boolean — Is no load locks or straps
          - `noSameDayReschedules` boolean — Is no same day reschedules
          - `notAllowedOnDock` boolean — Is not allowed on dock
          - `noTankTops` boolean — Is no tank tops
          - `noTrailerDetentionOrLayover` boolean — Is no trailer detention or layover
          - `noWorkIns` boolean — Is no work ins
          - `onSiteParkingAvailable` boolean — Whether on site parking available
          - `overnightParkingAvailable` boolean — Is overnight parking available
          - `payLumperWCashTCheck` boolean — PayLumperWCashTCheck
          - `preLoadDropTrailerXHoursInAdvance` integer — Pre load drop trailer in advance
          - `prePaidLumperService` boolean — Is prepaid lumper service
          - `residentialDelivery` boolean — Is residential delivery
          - `residentialPickup` boolean — Is residential pickup
          - `safetyGlasses` boolean — Is safety glasses
          - `safetyVest` boolean — Is safety vest
          - `scaleEmpty` boolean — Is scale empty
          - `scaleHeavy` boolean — Is scale heavy
          - `secureYard` boolean — Is secure yard
          - `sortAndSegregateDelivery` boolean — Whether to sort and segregate delivery
          - `sortAndSegregatePickup` boolean — Whether to sort and segregate pickup
          - `spanishSpeaking` boolean — Is Spanish speaking
          - `steelToeShoes` boolean — Is steel toe shoes
          - `strictAppt` boolean — Is strict appt
          - `tradeshowDelivery` boolean — Is trade show delivery
          - `tradeshowPickup` boolean — Is trade show pickup
          - `trailerInspectionFormRequired` boolean — Whether trailer inspection form required
          - `twic` boolean — Is TWIC
          - `twicRequiredNoEscorts` boolean — Is TWIC required no escorts
          - `uiia` boolean — Is UIIA
          - `unpackDetrash` boolean — Is unpack detrash
          - `usCitizen` boolean — Is US citizen
          - `validUSCommercialDriversLicenseHardcopy` boolean — Is valid US commercial drivers license hardcopy
          - `xTankOfFuelAtShipper` integer — Number of tank of fuel at shipper
        - `stopNotes` string, nullable — Stop notes
        - `workType` 'Undefined' | 'NoTouch' | 'DriverLoad' | 'DriverCount' | 'Lumper' | 'AssistCheck' — Driver work type
        - `genericAttributes` CoyoteSystemsExternalApiContractsModelsAvailableLoadsGenericAttributeItem[], nullable — Generic Attributes
          - `key` string, required — Unique name
          - `displayText` string, required — Display name
  - `pagination` CoyoteSystemsExternalApiContractsModelsAvailableLoadsPagination — Pagination information
    - `limit` integer, nullable — Limit
    - `offset` integer, nullable — Offset
    - `totalCount` integer — Total loads found

## Other responses

- `204` — Loads do not exist or are not available anymore
- `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)
