Overview
Use the following information to write a client application to integrate your TMS or other system to the project44 platform through our LTL Rating & Dispatch APIs.
More robust user guides are coming soon – stay tuned!
LTL Rating Workflow
LTL Dispatch Workflow
- Create a Shipment.
- Cancel a Shipment.
LTL Imaging Workflow
Postman Collection
Try the LTL Rating & Dispatch APIs without writing code. Download both files, import them into Postman, and select the project44 LTL — NA Production environment.
Set clientId and clientSecret to your OAuth2 client application credentials, then run 1. Setup and the remaining folders in order. The collection fetches and caches the bearer token for you.
Warning: the collection targets NA production. Dispatch Shipment books a real shipment with a real carrier and there is no documented idempotency mechanism, so sending it twice may book two shipments. Check the result of the first request before retrying. Setup, Rating and Documents are read-only.
Workflow Details
Rating
Query for Rate Quotes
Acquire both rate quotes and transit times from requested LTL Capacity Providers.
| Endpoint | /api/v4/ltl/quotes/rates/query |
| Verb | POST |
| Required Fields | origin and destination postal codes; at least one of line items (package weight, dimensions, and freightclass) or enhanced handling units* |
*PLEASE CONTACT YOUR ACCOUNT MANAGER AT PROJECT44 BEFORE USING THE ENHANCED HANDLING UNITS FIELD.
Query for Transit Quote Times
Acquire only transit times from requested LTL Capacity Providers.
| Endpoint | /api/v4/ltl/quotes/transittimes/query |
| Verb | POST |
| Required Fields | origin and destination postal codes |
Dispatch
Create a Shipment
Create and dispatche the LTL Shipment to the your chosen Capacity Provider.
| Endpoint | /api/v4/ltl/dispatchedshipments |
| Verb | POST |
| Required Fields | Capacity Provider account group code, origin and destination address and contact information, requester location and contact information, package information (weight, dimensions, freight class, hazmat details), enhanced handling units*, pickup and delivery window dates and times, carrier code (if the capacity provider supports multiple SCACs), emergency contact (if the shipment contains hazardous materials), Capacity Provider quote number |
*PLEASE CONTACT YOUR ACCOUNT MANAGER AT PROJECT44 BEFORE USING ENHANCED HANDLING UNITS FIELD.
Cancel a Dispatched Shipment by Shipment Identifier
Cancel a dispatched LTL Shipment using a chosen ID such as a PRO Number or BOL.
| Endpoint | /api/v4/ltl/shipments/cancellations |
| Verb | POST |
| Required Fields | Capacity Provider account group, origin postal code, shipment ID |
Cancel a Dispatched Shipment by ID
Cancel a dispatched LTL Shipment using the project44-generated ID.
| Endpoint | /api/v4/ltl/shipments/{id}/cancellations |
| Verb | POST |
| Required Fields | project44-generated ID, Capacity Provider account group, origin postal code |
Generate a ProNumber for Specific Vendor
Generates a PRO Number for a specific vendor (Capacity Provider).
| Endpoint | /api/v4/shipments/pronumbers/query |
| Verb | POST |
| Required Fields | Capacity Provider account group |
Imaging
Query for LTL Shipment Images
Accesse any document images such as BOLs, Lumper Certificates, and Invoices for a shipment that the Capacity Provider has made available.
| Endpoint | /api/v4/ltl/images/query |
| Verb | POST |
| Required Fields | Capacity Provider account group, ProNumber, destination postal code, document type (BILL_OF_LADING, DELIVERY_RECEIPT, WEIGHT_CERTIFICATE, INVOICE, INSPECTION_CERTIFICATE, LETTER_OF_AUTHORIZATION, LUMPER_CERTIFICATE, PACKING_SLIP) |