Coyote Logistics Carrier - Booking APIs API
The Carrier - Booking APIs API from Coyote Logistics — 2 operation(s) for carrier - booking apis.
The Carrier - Booking APIs API from Coyote Logistics — 2 operation(s) for carrier - booking apis.
openapi: 3.0.1
info:
title: CoyoteGO Associated Entities API Carrier - Booking APIs API
description: "# Introduction\r\n\r\nWelcome to CoyoteGO's API Documentation. Carriers can use our APIs to search for and book themselves on available loads and \r\nsubmit or retrieve load related documents. Shippers can access instant Truckload and Less-than-Truckload quotes, build loads, \r\nand retrieve real time tracking updates.\r\n\r\nIf you're an existing Coyote Carrier or Shipper, and want to utilize the API, you can request an API key through your \r\nCoyote sales rep or by emailing apimanagement@coyote.com.\r\n\r\n__North American Partners__: By accessing or using the CoyoteGO APIs or the API Technical Documentation for the CoyoteGO APIs,\r\nyou are agreeing to the [Coyote North American API Terms of Use](https://www.coyote.com/terms-privacy/#api).\r\n\r\n__European Partners__: Your access and use of the CoyoteGO APIs or the API Technical Documentation for the CoyoteGO APIs is \r\nsubject to your signed [Coyote European API Agreement](https://coyote.na1.echosign.com/public/esignWidget?wid=CBFCIBAA3AAABLblqZhC8nwKw53LddjQC3fsNIKa4hPi7iJT2vNmxbbeN2ePV-SI-nKqSjzcUifUXT0oyVdM*)\r\n\r\n## Authentication\r\n\r\nOnce you've received your API key, you can now access the sandbox environment where you can begin to work with the endpoints.\r\n\r\nTo retrieve a token, POST to api.coyote.com/connect/token, specifying the following token request parameters. Token requests must be form-urlencoded.\r\n\r\nclient_id (provided by integrations team) \r\nclient_secret (provided by integrations team) \r\ngrant_type (client_credentials) \r\n\r\nExample:\r\n\r\n```\r\nPOST /connect/token\r\n\r\n client_id=client1&\r\n client_secret=api_key&\r\n grant_type=client_credentials&\r\n```\r\n\r\nPass your token as a bearer token in an Authorization header.\r\n\r\nOf note:\r\nThe API is organized around REST. All requests should be made over SSL. All API request and response bodies are encoded in JSON. \r\n\r\nTo test your requests and responses, use api-sandbox.coyote.com with your sandbox API key.\r\n\r\n**NOTE:** *We are migrating to a persistent testing environment that will respond with real responses instead of mock data. We will be notifying shippers as we move them over to this environment. \r\nIf provided with a Demo API key please use **api.demo.coyote.com** for testing the APIs.*\r\n"
contact:
name: API Management
email: apimanagement@coyote.com
version: v0.1.1.2549
x-logo:
url: https://coyote.com/wp-content/uploads/2020/02/APILogo-transparent.png
altText: Coyote
servers:
- url: https://api.demo.coyote.com
description: Demo
- url: https://api.coyote.com
description: Production
- url: https://api-sandbox.coyote.com
description: Sandbox
tags:
- name: Carrier - Booking APIs
paths:
/api/v1/Booking:
post:
tags:
- Carrier - Booking APIs
summary: Submit a booking request
description: Allows Carriers to submit a booking request with relevant load information.
requestBody:
description: The document type requested
content:
application/json:
schema:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.Booking.BookingRequest'
example:
carrierId: 194536367
load:
loadId: 194536334
orderNumber: null
loadDetails:
rate:
value: 654.0
currencyType: USD
mode: TL
equipment:
equipmentHeight:
value: 0.0
unit: Feet
equipmentLength:
value: 53.0
unit: Feet
equipmentType: V
equipmentWidth:
value: 20.0
unit: Feet
equipmentAttributes:
foodGrade: true
paperGrade: false
preCoolRequired: false
liftGate: false
palletJack: false
airRide: false
trailerXYearsOrNewer: 0
xLoadLocks: 0
xLoadBars: 0
xLoadStraps: 0
xSideboards: 0
eTrack: false
chains: false
noRollDoor: false
rollDoorAllowed: false
noReefer: false
noLiftGate: false
doubleTrailer: false
tripleTrailer: false
loadOutTrailer: false
towAway: false
lightweightEquipment: false
scaleUpToXPounds: 0
scaleUpToXKilograms: 0
tandemSlide: false
downloadableReefer: false
spaceSaverReefer: false
translucentTop: false
duraplate: false
ventedVan: false
functionalAirChute: false
trailerMustHaveAllWoodFloors: false
xlCode: false
genericAttributes: null
loadDistance:
value: 1500.0
unit: Miles
weight:
value: 1800.0
unit: Pounds
temperatureSettings:
preCoolTemperature: null
maximumTemperature:
value: 12.0
unit: Fahrenheit
minimumTemperature:
value: 20.0
unit: Fahrenheit
loadAttributes:
airRide: false
blind: false
bondedCarrier: false
borderCrossingByCoyote: false
borderCrossingByCustomer: false
coyoteGo: false
crossBorderMexico: false
ctpat: false
disasterRelief: false
doubleBlind: false
doubleTrailer: false
drayage: false
duraplate: false
englishSpeaking: false
exitPass: false
fast: false
fdaClearanceRequired: false
floodRelief: false
govt: false
guaranteed: false
haccp: false
hazmatEndorsement: false
hvhr: false
hvhrPlus: false
intraMexico: false
liquor: false
neec: false
noCameraPhonePhotosOfPaperwork: false
overDimension: false
palletJack: false
partialLoad: false
pipOrPep: false
powerOnly: false
ppe: false
protectFromFreeze: false
repairReceiptRequiredForBreakdowns: false
seal: true
secondaryBorderInspection: false
tankerEndorsement: false
tcr: false
team: false
techTrackingRequired: false
tradeShow: false
trailerControl: false
transloadByCoyote: false
transloadByCustomer: false
tripleTrailer: false
twic: false
uiia: false
genericAttributes: null
stops:
- sequence: 1
stopType: Pickup
facility:
name: null
address:
line1: 16005 WAHRMAN ST
line2: null
line3: null
postalCode: 48174-9725
cityName: Romulus
stateProvinceCode: OH
countryCode: US
geoCoordinates:
latitude: 40.246281
longitude: -82.868742
timeZoneOffset: -04:00:00
appointment:
facilityOpenDateTimeUtc: null
facilityCloseDateTimeUtc: null
appointmentStartDateTimeUtc: '2026-06-14T18:33:48.4370238Z'
appointmentEndDateTimeUtc: '2026-06-14T18:33:48.437024Z'
stopDetails: null
- sequence: 2
stopType: Delivery
facility:
name: null
address:
line1: 131 State Route 3
line2: null
line3: null
postalCode: '43074'
cityName: Sunbury
stateProvinceCode: OH
countryCode: US
geoCoordinates:
latitude: 41.246281
longitude: -81.868742
timeZoneOffset: -05:00:00
appointment:
facilityOpenDateTimeUtc: null
facilityCloseDateTimeUtc: null
appointmentStartDateTimeUtc: '2026-06-14T18:33:48.4370244Z'
appointmentEndDateTimeUtc: '2026-06-14T18:33:48.4370245Z'
stopDetails: null
responses:
'200':
description: Booking request was accepted
content:
application/json:
schema:
type: string
format: uuid
example: 94c34c2c-cf92-402a-a02b-48df9af5e649
'409':
description: Conflict
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.Booking.BookingConflict'
example:
- description: Eligible
bookingValue: ''
currentValue: 'False'
sequence: 0
- description: TotalWeight
bookingValue: 2500
currentValue: 2700
sequence: 0
- description: MinimumTemperature
bookingValue: -100
currentValue: -99
sequence: 0
- description: MaximumTemperature
bookingValue: 100
currentValue: 99
sequence: 0
- description: EquipmentType
bookingValue: V
currentValue: R
sequence: 0
- description: EquipmentHeight
bookingValue: 50
currentValue: 60
sequence: 0
- description: EquipmentWidth
bookingValue: 50
currentValue: 60
sequence: 0
- description: EquipmentLength
bookingValue: 50
currentValue: 60
sequence: 0
- description: Rate
bookingValue: 1000
currentValue: 1000
sequence: 0
- description: Mode
bookingValue: 2
currentValue: 3
sequence: 0
- description: Stops.Count
bookingValue: 2
currentValue: 3
sequence: 0
- description: Stop.Sequence
bookingValue: null
currentValue: 1
sequence: 1
- description: Stop.StateCode
bookingValue: MI
currentValue: IL
sequence: 2
- description: Stop.CityName
bookingValue: Detroit
currentValue: Chicago
sequence: 2
- description: Stop.AppointmentStartDateTimeUtc
bookingValue: '1753-01-01T00:00:00'
currentValue: '2020-05-18T00:00:00'
sequence: 1
- description: Stop.FacilityOpenDateTimeUtc
bookingValue: '1753-01-01T00:00:00'
currentValue: '2020-05-18T00:00:00'
sequence: 1
- description: Stop.AppointmentEndDateTimeUtc
bookingValue: '1753-01-01T00:00:00'
currentValue: '2020-05-18T00:00:00'
sequence: 1
- description: Stop.FacilityCloseDateTimeUtc
bookingValue: '1753-01-01T00:00:00'
currentValue: '2020-05-18T00:00:00'
sequence: 1
'400':
description: Invalid request
'401':
description: Unauthorized
'403':
description: Forbidden
/api/v1/Booking/{bookingRequestId}/status:
get:
tags:
- Carrier - Booking APIs
summary: Get booking request status
description: Allows Carriers to retrieve the current booking status for a previously submitted booking request.
parameters:
- name: bookingRequestId
in: path
required: true
schema:
type: string
nullable: true
responses:
'200':
description: The booking request status successfully retrieved and returned
content:
application/json:
schema:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.Booking.BookingRequestStatus'
'400':
description: Invalid request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: The booking request does not exist
components:
schemas:
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.TemperatureSettings:
type: object
properties:
preCoolTemperature:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Temperature'
maximumTemperature:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Temperature'
minimumTemperature:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Temperature'
additionalProperties: false
description: Defines the temperature settings of load
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.TrackingAddress:
required:
- cityName
- countryCode
- line1
- postalCode
- stateProvinceCode
type: object
properties:
line1:
type: string
description: Line 1
line2:
type: string
description: Line 2
nullable: true
line3:
type: string
description: Line 3
nullable: true
postalCode:
type: string
description: Postal Code
cityName:
type: string
description: City Name
stateProvinceCode:
type: string
description: State or Province Code
countryCode:
type: string
description: Country Code
additionalProperties: false
description: Address
Coyote.Systems.ExternalApi.Contracts.Models.Booking.BookingRequestStatus:
type: object
properties:
loadId:
type: integer
description: Coyote Load Id
format: int32
carrierId:
type: integer
description: Coyote Carrier Id
format: int32
status:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.BookingStatus'
validationMessages:
type: array
items:
type: string
description: Validation messages
nullable: true
additionalProperties: false
description: Booking request status response
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.GeoCoordinates:
required:
- latitude
- longitude
type: object
properties:
latitude:
type: number
description: Latitude
format: double
longitude:
type: number
description: Longitude
format: double
additionalProperties: false
description: GeoCoordinates
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.LoadStopAttributes:
type: object
properties:
blind:
type: boolean
description: Is blind
closedToeShoes:
type: boolean
description: Is closed toe shoes
detentionAuthFormRequired:
type: boolean
description: Is detention auth form required
driverAssist:
type: boolean
description: Whether driver assist
dropAndHook:
type: boolean
description: Is drop and hook
dropTrailerAllowXHoursToUnload:
type: integer
description: Allow hours to unload
format: int32
dropTrailerRequired:
type: boolean
description: Is drop trailer required
earPlugs:
type: boolean
description: Ear plugs
englishSpeaking:
type: boolean
description: Is English speaking
escortOrTwicRequired:
type: boolean
description: Whether escort or twic Required
exitPass:
type: boolean
description: Exit pass
government:
type: boolean
description: Is government
hardHat:
type: boolean
description: Is hard hat
inOutTimesWSignature:
type: boolean
description: Are in out times with signature
insideDelivery:
type: boolean
description: Is inside delivery
insidePickup:
type: boolean
description: Is inside pickup
legalScaleOnSite:
type: boolean
description: Is legal scale on site
liftgateDelivery:
type: boolean
description: Is liftgate delivery
liftgatePickup:
type: boolean
description: Is liftgate pickup
limitedAccessDeliveryAirport:
type: boolean
description: Is limited access delivery airport
limitedAccessDeliveryChurch:
type: boolean
description: Is limited access delivery church
limitedAccessDeliveryConstructionSite:
type: boolean
description: Is limited access delivery construction site
limitedAccessDeliveryFarm:
type: boolean
description: Is limited access delivery farm
limitedAccessDeliveryMilitaryBase:
type: boolean
description: Is limited access delivery military base
limitedAccessDeliveryMineSite:
type: boolean
description: Is limited access delivery mine site
limitedAccessDeliveryMiniStorage:
type: boolean
description: Is limited access delivery mini storage
limitedAccessDeliveryOther:
type: boolean
description: Is limited access delivery other
limitedAccessDeliveryPrison:
type: boolean
description: Is limited access delivery prison
limitedAccessDeliveryRemoteGovt:
type: boolean
description: Is limited access delivery remote govt
limitedAccessDeliverySchool:
type: boolean
description: Is limited access delivery school
limitedAccessPickupAirport:
type: boolean
description: Is limited access pickup airport
limitedAccessPickupChurch:
type: boolean
description: Is limited access pickup church
limitedAccessPickupConstructionSite:
type: boolean
description: Is limited access pickup construction site
limitedAccessPickupFarm:
type: boolean
description: Is limited access pickup farm
limitedAccessPickupMilitaryBase:
type: boolean
description: Is limited access pickup military base
limitedAccessPickupMineSite:
type: boolean
description: Is limited access pickup mine site
limitedAccessPickupMiniStorage:
type: boolean
description: Is limited access pickup mini storage
limitedAccessPickupOther:
type: boolean
description: Is limited access pickup other
limitedAccessPickupPrison:
type: boolean
description: Is limited access pickup prison
limitedAccessPickupRemoteGovt:
type: boolean
description: Is limited access pickup remote govt
limitedAccessPickupSchool:
type: boolean
description: Is limited access pickup school
liquorPermit:
type: boolean
description: Is liquor permit
loadedToLegalWeight:
type: boolean
description: Is loaded to legal weight
longPants:
type: boolean
description: Is long pants
longSleeves:
type: boolean
description: Is long sleeves
lumperReceiptRequired:
type: boolean
description: Whether lumper receipt required
mustCheckInAsCoyote:
type: boolean
description: Must check in as Coyote
mustProvideAndApplySeal:
type: boolean
description: Whether must provide and apply seal
mustSecureLoad:
type: boolean
description: Whether must secure load
needCoyoteApprovalToUseLumperService:
type: boolean
description: Is Coyote approval needed to use lumper service
noAnimals:
type: boolean
description: Is no animals
noDetention:
type: boolean
description: Is no detention
noEarlyDeliveries:
type: boolean
description: Whether no early deliveries
noLoadLocksOrStraps:
type: boolean
description: Is no load locks or straps
noSameDayReschedules:
type: boolean
description: Is no same day reschedules
notAllowedOnDock:
type: boolean
description: Is not allowed on dock
noTankTops:
type: boolean
description: Is no tank tops
noTrailerDetentionOrLayover:
type: boolean
description: Is no trailer detention or layover
noWorkIns:
type: boolean
description: Is no work ins
onSiteParkingAvailable:
type: boolean
description: Whether on site parking available
overnightParkingAvailable:
type: boolean
description: Is overnight parking available
payLumperWCashTCheck:
type: boolean
description: PayLumperWCashTCheck
preLoadDropTrailerXHoursInAdvance:
type: integer
description: Pre load drop trailer in advance
format: int32
prePaidLumperService:
type: boolean
description: Is prepaid lumper service
residentialDelivery:
type: boolean
description: Is residential delivery
residentialPickup:
type: boolean
description: Is residential pickup
safetyGlasses:
type: boolean
description: Is safety glasses
safetyVest:
type: boolean
description: Is safety vest
scaleEmpty:
type: boolean
description: Is scale empty
scaleHeavy:
type: boolean
description: Is scale heavy
secureYard:
type: boolean
description: Is secure yard
sortAndSegregateDelivery:
type: boolean
description: Whether to sort and segregate delivery
sortAndSegregatePickup:
type: boolean
description: Whether to sort and segregate pickup
spanishSpeaking:
type: boolean
description: Is Spanish speaking
steelToeShoes:
type: boolean
description: Is steel toe shoes
strictAppt:
type: boolean
description: Is strict appt
tradeshowDelivery:
type: boolean
description: Is trade show delivery
tradeshowPickup:
type: boolean
description: Is trade show pickup
trailerInspectionFormRequired:
type: boolean
description: Whether trailer inspection form required
twic:
type: boolean
description: Is TWIC
twicRequiredNoEscorts:
type: boolean
description: Is TWIC required no escorts
uiia:
type: boolean
description: Is UIIA
unpackDetrash:
type: boolean
description: Is unpack detrash
usCitizen:
type: boolean
description: Is US citizen
validUSCommercialDriversLicenseHardcopy:
type: boolean
description: Is valid US commercial drivers license hardcopy
xTankOfFuelAtShipper:
type: integer
description: Number of tank of fuel at shipper
format: int32
additionalProperties: false
description: Defines the Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.LoadStopAttributes.
Coyote.Systems.ExternalApi.Contracts.Models.StopType:
enum:
- None
- Pickup
- Delivery
- ContainerDepotOrigin
- ContainerDepotTermination
- OriginRamp
- DestinationRamp
- OriginPort
- DestinationPort
- OriginAirport
- DestinationAirport
- CrossDock
type: string
description: Stop Types
Coyote.Systems.ExternalApi.Contracts.Models.TemperatureUnit:
enum:
- Fahrenheit
- Celsius
type: string
description: Temperature Units
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.EquipmentDetails:
required:
- equipmentAttributes
- equipmentHeight
- equipmentLength
- equipmentType
- equipmentWidth
type: object
properties:
equipmentHeight:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Dimension'
equipmentLength:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Dimension'
equipmentType:
type: string
description: Equipment type
equipmentWidth:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Dimension'
equipmentAttributes:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.EquipmentAttributes'
genericAttributes:
type: array
items:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.GenericAttributeItem'
description: Collection of generic attributes
nullable: true
additionalProperties: false
description: Equipment details
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Appointment:
type: object
properties:
facilityOpenDateTimeUtc:
type: string
description: Facility Open DateTime in Utc
format: date-time
nullable: true
facilityCloseDateTimeUtc:
type: string
description: Facility Close DateTime in Utc
format: date-time
nullable: true
appointmentStartDateTimeUtc:
type: string
description: Appointment Start DateTime in Utc
format: date-time
nullable: true
appointmentEndDateTimeUtc:
type: string
description: Appointment End DateTime in Utc
format: date-time
nullable: true
additionalProperties: false
description: Appointment
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.LoadCommodity:
required:
- description
- weight
type: object
properties:
description:
type: string
description: Description of load commodity
weight:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Weight'
additionalProperties: false
description: Defines the load commodity
Coyote.Systems.ExternalApi.Contracts.Models.Booking.BookingConflict:
type: object
properties:
description:
type: string
description: Description of the conflict field/data
nullable: true
bookingValue:
type: object
additionalProperties: false
description: Booking request value
nullable: true
currentValue:
type: object
additionalProperties: false
description: Current Coyote value
nullable: true
sequence:
type: integer
description: Object sequence in a list
format: int32
additionalProperties: false
description: Booking request conflict response
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Facility:
required:
- address
- geoCoordinates
- name
- timeZoneOffset
type: object
properties:
name:
type: string
description: Name
address:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.TrackingAddress'
geoCoordinates:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.GeoCoordinates'
timeZoneOffset:
$ref: '#/components/schemas/System.TimeSpan'
additionalProperties: false
description: Facility
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.AvailableLoad:
required:
- loadDetails
- loadId
- stops
type: object
properties:
loadId:
type: integer
description: Available load ID
format: int32
orderNumber:
type: string
description: Order number
nullable: true
loadDetails:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.LoadDetails'
stops:
type: array
items:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.LoadStop'
description: Load stops information
additionalProperties: false
description: Available load information
Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.LoadDetails:
required:
- equipment
- loadAttributes
- loadDistance
- mode
- rate
- temperatureSettings
- weight
type: object
properties:
rate:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Rate'
mode:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.Mode'
equipment:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.EquipmentDetails'
loadDistance:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Distance'
weight:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.Weight'
temperatureSettings:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.TemperatureSettings'
loadAttributes:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.LoadAttributes'
genericAttributes:
type: array
items:
$ref: '#/components/schemas/Coyote.Systems.ExternalApi.Contracts.Models.AvailableLoads.GenericAttributeItem'
description: Collection of generic attributes
nullable: true
additionalProperties: false
description: Load details
# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/coyote/refs/heads/main/openapi/coyote-carrier-booking-apis-api-openapi.yml