Connect LTL Carrier Accounts

ShipEngine API allows you to connect your existing LTL carrier accounts to your ShipEngine API account programmatically rather than having to log in to the ShipEngine API dashboard. You'll add the credentials required to access the carrier's API in the requests described below. Keep in mind, however, that rates will be based on the account information you provide in the quote request.

Carrier Codes

In the requests below, you will need to know the carrier code for your LTL carrier. This code will be passed in the URL as a query string. This is what tells ShipEngine API which carrier you are connecting.

The carrier codes are mapped to the carriers' SCACs, and many carriers have more than one. The SCACs may correspond to different services or other arrangements that the carrier offers. For more information about the individual SCACs listed, contact the carrier.

Connect Carrier Request

Each LTL carrier uses its own format for authentication, so the information your application must pass to connect an account through ShipEngine API depends on the carrier. You can find the requirements for connecting each LTL carrier available through ShipEngine API, including the credential requirements, and an example request, below. Additionally, you can list the credential requirements for a specific carrier.

Connect Carrier Response

While the connection request body looks different for each carrier, the response from ShipEngine API has the same shape regardless of which carrier you are using. An example request is included with the credential requirements for each carrier, and the example response below applies to all carriers.

The response includes the carrier_id that ShipEngine API has assigned to this carrier connection within your ShipEngine API account. This carrier_id is only valid for your account. You will use this carrier_id in subsequent API requests.

Example Response

1
2
3
{
  "carrier_id": "car_vsY7PLz7KEs48vh9"
}

Carriers

➤

AAA Cooper Transportation

Connection Information

Property	Type	Required	Description
key	string	✔	The key provided by the carrier.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/aact

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
POST /v-beta/ltl/connections/aact HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
      "key": "The key provided by the carrier.",
      "account_number": "The account number for your account with the carrier."
  }
}

➤

ABF Freight Systems Inc.

Connection Information

Property	Type	Required	Description
username	string	✔	The API ID generated by the carrier.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/abfs

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
POST /v-beta/ltl/connections/abfs HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "The API ID generated by the carrier.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

A. Duie Pyle Inc.

Connection Information

Property	Type	Required	Description
username	string	✔	Your aduiepyle.com Username.
password	string	✔	Your aduiepyle.com Password.
account_number	string	✔	The account number for your account with the carrier.

Copy

1
### Example Request

POST /v-beta/ltl/connections/pyle

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/pyle HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
    "username": "Your aduiepyle.com Username.",
    "password": "Your aduiepyle.com Password.",
    "account_number": "The account number for your account with the carrier."
  }
}

➤

Averitt Express Inc.

Connection Information

Property	Type	Required	Description
key	string	✔	Your averittexpress.com API Key.
username	string	✔	Your averittexpress.com Username.
password	string	✔	Your averittexpress.com Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/avrt

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
13
POST /v-beta/ltl/connections/avrt HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "key": "Your averittexpress.com API Key.",
     "username": "Your averittexpress.com Username.",
     "password": "Your averittexpress.com Password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Central Freight Lines

Connection Information

Property	Type	Required	Description
username	string	✔	Your centralfreight.com Username.
password	string	✔	Your Your centralfreight.com Password.
account_number	string	✔	The account number for your account with the carrier.

Copy

1
### Example Request

POST /v-beta/ltl/connections/cenf

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/cenf HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your centralfreight.com Username.",
     "password": "Your centralfreight.com Password",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Central Transport

Connection Information

Property	Type	Required	Description
key	string	✔	Access Code provided by the carrier.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/ctii

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
POST /v-beta/ltl/connections/ctii HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "key": "Access Code provided by the carrier.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Daylight Transport LLC

Connection Information

Property	Type	Required	Description
username	string	✔	MyDaylight username.
password	string	✔	MyDaylight password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/dylt

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/dylt HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "MyDaylight username",
     "password": "MyDaylight password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Day & Ross

Connection Information

Property	Type	Required	Description
username	string	✔	Day and Ross Account Email.
password	string	✔	Day and Ross Account Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/dayr

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/dayr HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Day and Ross Account Email.",
     "password": "Day and Ross Account Password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Dayton Freight Lines Inc.

Connection Information

Property	Type	Required	Description
username	string	✔	Your daytonfreight.com Username.
password	string	✔	Your daytonfreight.com Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/dafg

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/dafg HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your daytonfreight.com Username.",
     "password": "Your daytonfreight.com Password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Dependable Highway Express

Connection Information

Property	Type	Required	Description
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/dphe

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
POST /v-beta/ltl/connections/dphe HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
    "account_number": "The account number for your account with the carrier."
  }
}

➤

Estes Express Lines

Connection Information

Property	Type	Required	Description
username	string	✔	Your MyEstes.com Username.
password	string	✔	Your MyEstes.com Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/exla

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/exla HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your MyEstes.com Username.",
     "password": "Your MyEstes.com Password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

FedEx Freight New REST API

Connection Information

This connection information applies to the following SCACs: FXFR and FXNR.

• FedEx LTL Freight Priority (FXFR) is the premier carrier for all points in the U.S., Canada and Mexico, specializing in next and second day markets.

• FedEx Freight Economy (FXNR) is the premier carrier for all points in the U.S, specializing in long haul markets.

  The SCAC is only relevant if you are requesting a quote for contracted rates. For spot quotes and bulk quotes, you can use either SCAC to connect your FedEx Freight account to your ShipEngine API account.

  Property	Type	Required	Description
  username	string	✔	FedEx API key or client_id.
  password	string	✔	FedEx secret key, or client_secret.
  secret	string	✔	Spot Quote Authentication Key generated by the carrier used for volume pricing only.
  securitycode	string	✔	Your FedEx account number.

  The client_id and client_secret values are generated by FedEx’s new REST API developer portal. You must create a FedEx developer account to obtain these credentials, which will require your FedEx account user ID and password.

  To learn how to obtain the required credentials, review the steps in this FedEx guide.

  Example Request

  POST /v-beta/ltl/connections/:carrier_code

  Copy

  HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  POST /v-beta/ltl/connections/fxfr HTTP/1.1
  Host: api.shipengine.com
  API-Key: __YOUR_API_KEY_HERE__
  Content-Type: application/json
  {
    "credentials": {
       "username": "client_id from FedEx developer portal.",
       "password": "client_secret from FedEx developer portal.",
       "secret": "Spot Quote Authentication Key generated by the carrier used for volume pricing only.",
       "securitycode": "Your FedEx account number."
    }
  }

➤

Forward Air Inc.

Connection Information

Property	Type	Required	Description
username	string	✔	Your API Username.
password	string	✔	Your API Password.
key	string	✔	Access Code provided by the carrier.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/fwdn

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
13
POST /v-beta/ltl/connections/fwdn HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your API Username.",
     "password": "Your API Password.",
     "key": "Access Code provided by the carrier.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Midwest Motor Express

Connection Information

Property	Type	Required	Description
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/midw

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
POST /v-beta/ltl/connections/midw HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
    "account_number": "The account number for your account with the carrier."
  }
}

➤

Oak Harbor Freight Lines Inc.

Connection Information

Property	Type	Required	Description
key	string	✔	API Key provided by the carrier.
username	string	✔	Email address used to register for MyOHFL at oakh.com.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/oakh

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/oakh HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "key": "API Key provided by the carrier.",
     "username": "Email address used to register for MyOHFL at oakh.com.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Old Dominion Freight Lines Inc.

Connection Information

Property	Type	Required	Description
username	string	✔	Your ODFL4me Username.
password	string	✔	Your ODFL4me Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/odfl

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/odfl HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your ODFL4me username.",
     "password": "Your ODFL4me password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Pitt-Ohio

Connection Information

Property	Type	Required	Description
username	string	✔	Your works.pittohio.com Username.
password	string	✔	Your works.pittohio.com Password.
key	string	✔	Your irv numeric identifier value.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/pitd

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
13
POST /v-beta/ltl/connections/pitd HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your works.pittohio.com Username.",
     "password": "Your works.pittohio.com Password.",
     "key": "Your irv numeric identifier value.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

R & L Carriers Inc.

Connection Information

This connection information applies to the following SCACs: RLCA, RFLFC, RNLO, RLRR, RLFV, RLCA. Contact the carrier if you are unsure of which SCAC to use.

Property	Type	Required	Description
key	string	✔	API Key generated by the carrier after registering for their B2B API Tools.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/:carrier_code

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
POST /v-beta/ltl/connections/rnlo HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "key": "API Key generated by the carrier after registering for their B2B API Tools.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Roadrunner Transportation Services Inc.

Connection Information

Property	Type	Required	Description
username	string	✔	Your freight.rrts.com Username.
password	string	✔	Your freight.rrts.com Password.
secret	string		API Secret Key - Required for Document only.
key	string		Application Identifier - Required for Document only.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/rdfs

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
13
14
POST /v-beta/ltl/connections/rdfs HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your freight.rrts.com Username.",
     "password": "Your freight.rrts.com Password.",
     "secret": "API Secret Key - Required for Document only.",
     "key": "Application Identifier - Required for Document only.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

SAIA Motor Freight Lines Inc.

Connection Information

Property	Type	Required	Description
username	string	✔	Your saia.com Username.
password	string	✔	Your saia.com Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/saia

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/saia HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your saia.com Username.",
     "password": "Your saia.com Password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Southeastern Freight Lines

Connection Information

Property	Type	Required	Description
username	string	✔	Your MySEFL Username.
password	string	✔	Your MySEFL Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/sefl

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/sefl HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your MySEFL Username.",
     "password": "Your MySEFL Password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Standard Forwarding

Connection Information

Property	Type	Required	Description
username	string	✔	STDF username.
password	string	✔	STDF password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/stdf

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/stdf HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
    "username": "STDF username.",
    "password": "STDF password.",
    "account_number": "The account number for your account with the carrier."
  }
}

➤

UPS Freight

Connection Information

Property	Type	Required	Description
username	string	✔	Your ups.com Username.
password	string	✔	Your ups.com Password.
key	string	✔	Access Key.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/upgf

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
13
POST /v-beta/ltl/connections/upgf HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your ups.com Username.",
     "password": "Your ups.com Password.",
     "key": "Access Key.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

Ward Trucking

Connection Information

Property	Type	Required	Description
username	string	✔	Your wardtlctools.com Username.
password	string	✔	Your wardtlctools.com Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/ward

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/ward HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your wardtlctools.com Username.",
     "password": "Your wardtlctools.com Password.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

XPO Logistics (Con-Way Freight)

Connection Information

This connection information applies to the following SCACs: CNWY, CWCE, CWSE, CWNO, XPOL, and CWWE. Contact the carrier if you are unsure of which SCAC to use.

Property	Type	Required	Description
username	string	✔	Your ltl.xpo.com Username.
password	string	✔	Your ltl.xpo.com Password.
key	string	✔	Key provided by carrier for API consumer access.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/:carrier_code

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
13
POST /v-beta/ltl/connections/xpol HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your ltl.xpo.com Username.",
     "password": "Your ltl.xpo.com Password.",
     "key": "Key provided by carrier for API consumer access.",
     "account_number": "The account number for your account with the carrier."
  }
}

➤

YRC Freight Inc

Connection Information

This connection information applies to the following SCACs: RDWY, YFSY, and YRCA. Contact the carrier if you are unsure of which SCAC to use.

Property	Type	Required	Description
username	string	✔	Your my.yrcfreight.com Username.
password	string	✔	Your my.yrcfreight.com Password.
account_number	string	✔	The account number for your account with the carrier.

Example Request

POST /v-beta/ltl/connections/:carrier_code

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
POST /v-beta/ltl/connections/rwdy HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "credentials": {
     "username": "Your my.yrcfreight.com Username.",
     "password": "Your my.yrcfreight.com Password.",
     "account_number": "The account number for your account with the carrier."
  }
}