The J.B. Hunt 360 Connect API provides programmatic access to quoting, order management, shipment tracking, document management, and scheduling on the J.B. Hunt 360 logistics platform. Supports full-truckload (FTL) and less-than-truckload (LTL) shipment operations.
openapi: 3.1.0
info:
title: J.B. Hunt 360 Connect API
description: >-
The J.B. Hunt 360 Connect API provides programmatic access to quoting, order
management, shipment tracking, document management, and scheduling on the
J.B. Hunt 360 logistics platform. Supports full-truckload (FTL) and
less-than-truckload (LTL) shipment operations.
version: 1.0.0
contact:
name: J.B. Hunt Developer Support
url: https://developer.jbhunt.com/connect-360
license:
name: Proprietary
url: https://www.jbhunt.com/
servers:
- url: https://api.jbhunt.com
description: Production
paths:
/quotes:
post:
operationId: createQuote
summary: Request Quote
description: >-
Request an on-demand quote for full-truckload or LTL shipment at
current market or contractual rates.
tags:
- Quotes
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
origin:
type: object
properties:
city:
type: string
state:
type: string
postalCode:
type: string
destination:
type: object
properties:
city:
type: string
state:
type: string
postalCode:
type: string
shipmentType:
type: string
enum:
- FTL
- LTL
pickupDate:
type: string
format: date
responses:
'200':
description: Quote returned successfully.
content:
application/json:
schema:
type: object
properties:
quoteId:
type: string
rate:
type: number
currency:
type: string
validUntil:
type: string
format: date-time
shipmentType:
type: string
'401':
description: Unauthorized.
'400':
description: Bad request.
/orders:
post:
operationId: createOrder
summary: Create Order
description: >-
Create a new transportation order on the J.B. Hunt 360 platform.
tags:
- Orders
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
quoteId:
type: string
origin:
type: object
properties:
address:
type: string
city:
type: string
state:
type: string
postalCode:
type: string
destination:
type: object
properties:
address:
type: string
city:
type: string
state:
type: string
postalCode:
type: string
pickupDate:
type: string
format: date
deliveryDate:
type: string
format: date
responses:
'201':
description: Order created successfully.
content:
application/json:
schema:
type: object
properties:
orderId:
type: string
status:
type: string
'401':
description: Unauthorized.
get:
operationId: searchOrders
summary: Search Orders
description: Search and retrieve orders on the J.B. Hunt 360 platform.
tags:
- Orders
parameters:
- name: status
in: query
required: false
schema:
type: string
- name: fromDate
in: query
required: false
schema:
type: string
format: date
- name: toDate
in: query
required: false
schema:
type: string
format: date
responses:
'200':
description: Orders returned successfully.
content:
application/json:
schema:
type: object
properties:
orders:
type: array
items:
type: object
properties:
orderId:
type: string
status:
type: string
origin:
type: string
destination:
type: string
'401':
description: Unauthorized.
/orders/{orderId}:
get:
operationId: getOrder
summary: Get Order Details
description: Retrieve details for a specific order.
tags:
- Orders
parameters:
- name: orderId
in: path
required: true
schema:
type: string
responses:
'200':
description: Order details returned successfully.
content:
application/json:
schema:
type: object
properties:
orderId:
type: string
status:
type: string
origin:
type: object
destination:
type: object
pickupDate:
type: string
format: date
deliveryDate:
type: string
format: date
'404':
description: Order not found.
/tracking/{shipmentId}:
get:
operationId: trackShipment
summary: Track Shipment
description: >-
Get near real-time tracking information for a freight shipment.
tags:
- Tracking
parameters:
- name: shipmentId
in: path
required: true
schema:
type: string
responses:
'200':
description: Tracking information returned successfully.
content:
application/json:
schema:
type: object
properties:
shipmentId:
type: string
status:
type: string
currentLocation:
type: object
properties:
latitude:
type: number
longitude:
type: number
city:
type: string
state:
type: string
eta:
type: string
format: date-time
lastUpdated:
type: string
format: date-time
'404':
description: Shipment not found.
/documents:
post:
operationId: uploadDocument
summary: Upload Document
description: >-
Upload a document related to a J.B. Hunt shipment, such as a bill of
lading or proof of delivery.
tags:
- Documents
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
shipmentId:
type: string
documentType:
type: string
enum:
- BOL
- POD
- INVOICE
- OTHER
file:
type: string
format: binary
responses:
'201':
description: Document uploaded successfully.
'400':
description: Bad request.
get:
operationId: getDocuments
summary: Get Documents
description: >-
Retrieve documents related to a J.B. Hunt shipment.
tags:
- Documents
parameters:
- name: shipmentId
in: query
required: true
schema:
type: string
responses:
'200':
description: Documents returned successfully.
content:
application/json:
schema:
type: object
properties:
documents:
type: array
items:
type: object
properties:
documentId:
type: string
documentType:
type: string
uploadedAt:
type: string
format: date-time
downloadUrl:
type: string
'404':
description: No documents found.
/appointments:
post:
operationId: createAppointment
summary: Create Appointment
description: Set a pickup or delivery appointment for a shipment.
tags:
- Scheduling
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
orderId:
type: string
type:
type: string
enum:
- PICKUP
- DELIVERY
appointmentDate:
type: string
format: date
timeWindow:
type: object
properties:
start:
type: string
format: time
end:
type: string
format: time
responses:
'201':
description: Appointment created successfully.
'400':
description: Bad request.
tags:
- name: Quotes
description: Request shipping quotes and rates.
- name: Orders
description: Create, search, and manage transportation orders.
- name: Tracking
description: Near real-time freight shipment tracking.
- name: Documents
description: Upload and retrieve shipment documents.
- name: Scheduling
description: Manage pickup and delivery appointments.