LTL Rates Process

uShip provides rates and booking for multiple LTL carriers and commodities. This document provides an overview for the steps required to start integration and retrieve the rates and should be used as a reference; for more specific information, sandbox access and a Postman collection to test this integration, please contact apisupport@uship.com.

Pre-Integration

1. To get started, please register on our developer portal at developer.uship.com. You'll be contacted by one of our team members after registering. Please ensure to include your contact information, details about your company, and that you are looking for an LTL rates integration.
2. Team members will set up a call to discuss your integration. You'll need to supply the static IP addresses you'll need whitelisted. Once whitelisted, you will receive your sandbox API keys as well as a Postman collection for testing.

Obtaining a Rate

1. Authenticate with POST /oauth/token to retrieve your Client Credentials grant token. From the response, retrieve your access/refresh token. For more detail on access tokens and authentication, please see (Link Removed)
2. Create a rate request with POST v2/rateRequests. In the location header of the response, you will see a /raterequests/{rateRequestID}/rates. Copy this URI for the next step.
3. Retrieve your rates with GET /rateRequests/{rateRequestID}/rates. You will retrieve multiple rates with distinct rate IDs and details on each carrier. Copy the rate ID for the desired carrier for booking.

Booking a Rate

1. Accept and book your rate with POST /v2/rates/{rateId}/acceptance.
2. The carrier will accept your rate and details can be viewed within your uShip account.
3. Payment terms may vary depending on the integration; please contact your uShip partnerships team member for more details.