List Connected Carriers

This API endpoint returns a list of all your connected LTL carrier accounts, along with helpful information about each account, including the various accessorial services, container types, and service levels available.

Carrier IDs

Each of your LTL carriers has a unique carrier_id in ShipEngine. You can use this carrier_id for many other ShipEngine endpoints to indicate which account to use. For this endpoint, you may optionally pass the carrier_id to get details on a single carrier.

Container Types and Accessorial Services

If you have experience with LTL shipping, you are probably familiar with speaking about LTL shipments in terms of the container used for shipping as well as the possible accessorial services you might wish to utilize. In ShipEngine API, we have streamlined the terminology across different kinds of carriers. Any time you see package, this refers to the LTL shipper's container type offerings. Likewise, accessorial services are simply referred to as options in ShipEngine API.

Example Request

GET /v-beta/ltl/carriers/

GET /v-beta/ltl/carriers HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__

Example Response

{
  "carriers": [
    {
      "carrier_id": "car_NJuhsfkKkuxChJNtX6X5jwY8uH",
      "scac": "FXFE",
      "services": [
        {
          "code": "gtd_am",
          "name": "Guaranteed Morning"
        },
        {
          "code": "gtd_noon",
          "name": "Guaranteed Noon"
        },
        {
          "code": "gtd_pm",
          "name": "Guaranteed End of Day"
        },
        {
          "code": "stnd",
          "name": "Standard"
        }
      ],
      "packages": [
        {
          "code": "bag",
          "name": "Bag"
        },
        {
          "code": "pal",
          "name": "Pail"
        },
        {
          "code": "pcs",
          "name": "Piece"
        },
        {
          "code": "pkg",
          "name": "Package"
        },
        {
          "code": "skd",
          "name": "Skid"
        }
      ],
      "options": [
        {
          "code": "haz",
          "name": "Hazardous material",
          "attributes": {
            "name": {
              "type": "string",
              "title": "Emergency Contact Name"
            },
            "phone": {
              "type": "string",
              "title": "Emergency Contact Phone Number",
              "pattern": "([0-9]{10})"
            }
          }
        },
        {
          "code": "ipu",
          "name": "Inside pickup"
        },
        {
          "code": "lftp",
          "name": "Lift gate required at pickup"
        },
        {
          "code": "rep",
          "name": "Residential pickup"
        }
      ],
      "credential_requirements": {
        "password": {
          "type": "string",
          "title": "The secret password associated with your Authentication Key"
        },
        "secret": {
          "type": "string",
          "title": "Spot Quote Authentication Key generated by the carrier used for volume pricing only"
        },
        "key": {
          "type": "string",
          "title": "Authentication Key (Production) generated by the carrier"
        },
        "securitycode": {
          "type": "string",
          "title": "Your FedEx account number"
        },
        "username": {
          "type": "string",
          "title": "The associated meter number for your FedEx account number."
        }
      }
    }
  ]
}