Complete API reference for LTL Direct freight shipping, including rate requests, listing management, Bill of Lading, and tracking.


Getting Started

Base URLs

Environment URL Description
Sandbox https://api.ushipsandbox.com Test environment for development
Production https://api.uship.com Live production environment

Note: Sandbox and production environments require separate API keys.


Authentication

All API requests require Bearer token authentication.

Obtaining Your API Key

  1. Navigate to API Key Generation Page
  2. Generate your API key (specify sandbox or production)
  3. Include in all requests:
Authorization: Bearer <your_api_key>

Integration Guides

Guide Description
Sandbox Testing Guide Comprehensive sandbox testing documentation
uShip DeveloperHub Integration guides and tutorials

Support

For questions or assistance, contact: apisupport@uship.com

Server
https://api.uship.com

Production

https://api.ushipsandbox.com

Sandbox (Testing)

Server Variables

Self-serve Bearer token provided to you at https://www.uship.com/api-key-generation

Rate Requests

Create and manage rate requests. A rate request initiates the process of getting shipping quotes from carriers.

Get list of available rates for a rate request

Auth
Headers
Authorizationstring

Required. Required Authorization header containing access token

Path Params
idstring

Required. The rate request ID

Query String
developmentstring
GET /v2/raterequests/{id}/rates
Copy
Responses
200

200 response

401

Unauthorized

403

Forbidden

500

Internal server error

Response
Copy

Create a rate request

Auth
Headers
Authorizationstring

Required. Required Authorization header containing access token

Query String
developmentstring
Request Body
POST /v2/raterequests
Responses
201

201 response

Headers
Locationstring

URL containing the rate request ID

400

Bad Request

401

Unauthorized

500

Internal server error

Response
Copy

Rates

Retrieve and select shipping rates. Rates represent pricing quotes from carriers for your shipment.

Accept a rate

Allows a shipper or an integrator on a shipper's behalf to accept a rate

Auth
Headers
Authorizationstring

Required. Required Authorization header containing access token

Path Params
idstring

Required. The rate ID to accept

Request Body
v2RatesAcceptancePostRequestobject
insuranceobject

Required. Insurance

coverageobject

Required. coverage

currencyTypestring

Required. Currency type (ex. USD)

amountnumber

Required. Coverage amount

paymentMethodIdstring

Required. Payment method ID

POST /v2/rates/{id}/acceptance
Copy
Responses
202

202 response

Headers
Locationstring

GET acceptance status endpoint

Body
v2RatesAcceptancePost202Responseobject
messagestring

Accepted message

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal server error

Response
Copy

Retrieves the status of a rate acceptance request

Auth
Headers
Authorizationstring

Required. Required Authorization header containing access token

Path Params
executionIdstring

Required. The execution ID returned from the rate acceptance request

idstring

Required. The rate ID

GET /v2/rates/{id}/acceptance/status/{executionId}
Copy
Responses
200

200 response

v2RatesAcceptanceStatusGet200Responseobject
responsestring

Stringified JSON response of the rate acceptance request

statusCodenumber

The API response status code of the rate acceptance request

201

201 response

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal server error

Response
Copy

Listings

Manage freight listings. Listings represent shipments in the uShip marketplace.

Retrieves a listing from the uShip Marketplace by listingId

Allows integrator to retrieve listing information by listing ID

Auth
Path Params
listingIdinteger

Required. listingId of the listing that is to be returned

GET /v2/listings/{listingId}
Copy
Responses
200

OK

Listings Attachments

Manage attachments associated with listings, such as photos or documents.

Retrieves listing attachment information

Allows integrator to retrieve listing attachments by listing ID

Auth
Path Params
listingIdinteger

Required. listingId

attachmentIdinteger

Required. attachmentId

GET /v2/listings/{listingId}/attachments/{attachmentId}
Copy
Responses
200

OK

Response
Copy

Payment Methods

Manage payment methods for booking shipments.

Get All User's Payment Methods

Auth
Headers
Authorizationstring

Required. Required Authorization header containing access token

Query String
topLevelCommoditystring

Required. Required top level commodity

GET /v2/paymentmethods
Copy
Responses
200

Successfully retrieved payment methods

v2PaymentMethodsGet200Responseobject
totalCountnumber
items
objectobject

Credit Card

lastFourstring

Last four digits of credit card number

isPrimaryboolean

Indicates if default card or not

activeboolean

Indicates whether account is active or not

expirationobject
monthnumber

Expiration month

yearnumber

Expiration year

idstring

Unique ID

typeobject
valuestring

Type of payment method

Enum: creditcard,bankaccount,payonterms

issuerstring

Issuing institution

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal server error

501

Top level commodity not implemented yet

Response
Copy

Tracking

Track shipment status and location updates.

Retrieve tracking info

This endpoint allows you to retrieve latitude/longitude values, transit status, and the most recent location or address. If a recent location is not provided, these will be absent from the response.

Auth
Headers
Authorizationstring

Required. Bearer {your password grant bearer token}

Path Params
listingIdinteger

Required. listingId

GET /v2/listings/{listingId}/track
Copy
Responses
200

OK

Response
Copy

Bill Of Lading

Retrieve Bill of Lading documents. The BOL is the official shipping contract between shipper and carrier.

Get the preSigned url for bill of lading

Auth
Headers
Authorizationstring

Required. Required Authorization header containing access token

Path Params
idstring

Required. The listing ID

GET /v2/listings/{id}/billoflading
Copy
Responses
200

200 response

v2ListingBillofLadingGet200Responseobject
billOfLadingNumbernumber
documentobject

pre-signed url to access the bill of lading

hrefstring

pre-signed url

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal server error

Response
Copy

listing booked webhook

webhook sent when a listing is booked through an integration

Request Body

Information about the booked listing

POST ListingBooked
Copy
Responses
200

Return a 200 status to indicate that the data was received successfully

No response body
Response
Copy

transit status changed webhook

Request Body

Information about the booked transit status change

POST ShipmentTransitStatusChanged
Copy
Responses
200

Return a 200 status to indicate that the data was received successfully

No response body
Response
Copy

listing reference number added webhook

Request Body

Information about the reference number

POST ListingReferenceNumberAdded
Copy
Responses
200

Return a 200 status to indicate that the data was received successfully

No response body
Response
Copy

listing status changed webhook

Request Body

Information about the status change

POST ListingStatusChanged
Copy
Responses
200

Return a 200 status to indicate that the data was received successfully

No response body
Response
Copy

shipment delivery timeframe updated webhook

Request Body

Information about the delivery timeframe

POST ShipmentDeliveryTimeFrameUpdated
Copy
Responses
200

Return a 200 status to indicate that the data was received successfully

No response body
Response
Copy

listing attachment added webhook

Request Body

Information about the attachment

POST ListingAttachmentAdded
Copy
Responses
200

Return a 200 status to indicate that the data was received successfully

No response body
Response
Copy

listing price details updated webhook

Request Body

Information about the price details

POST ListingPriceDetailsUpdated
Copy
Responses
200

Return a 200 status to indicate that the data was received successfully

No response body
Response
Copy