List a Single LTL Carrier

This API endpoint returns details about a specific LTL carrier account, indicated by its carrier_id, 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. You will need it to get details on this carrier. If you do not know the carrier_id, you can list all carriers to get a list of all your connected LTL carrier accounts.

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/:carrier_id

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

Example Response

{
  "carrier_id": "car_NJuhsfkKkuxChJNtX6X5kJKKY7",
  "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."
    }
  }
}