--- title: "Submit a booking request" method: POST path: "/api/v1/Booking" tags: ["Carrier - Booking APIs"] --- # Submit a booking request `POST /api/v1/Booking` Allows Carriers to submit a booking request with relevant load information. ## Request body - CoyoteSystemsExternalApiContractsModelsBookingBookingRequest — Booking Request - `carrierId` integer — Coyote Carrier Id - `load` CoyoteSystemsExternalApiContractsModelsAvailableLoadsAvailableLoad, required — Available load information - `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 ## Response `200` Booking request was accepted - string, uuid ## Other responses - `400` — Invalid request - `401` — Unauthorized - `403` — Forbidden - `409` — Conflict --- [API](https://skmtc.net/coyote/apis/coyotego-api.md) · [All operations](https://skmtc.net/coyote/apis/coyotego-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coyote/coyotego-api/versions/1d3005ca5ad5/schema)