Get a Single LTL Carrier

This API endpoint returns a list of helpful information about a single LTL carrier account, including the available accessorial services, container types, and service levels for that particular LTL carrier account.

Carrier IDs

There is a unique carrier_id in ShipEngine for each of your LTL carriers. Use this carrier_id for many other ShipEngine endpoints to indicate a specific account you want to use.

This unique ID represents your connection with a specific carrier, and ShipEngine generates and returns this unique carrier_id when you connect a carrier account.

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 may wish to use. 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

GET /v-beta/ltl/carriers/:carrier_id

Example Request

1
2
3
GET /v-beta/ltl/carriers/aed2a8c0-7998-4fef-9a82-2cab5f527dc2 HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__

Example Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
{
  "carriers": [
    {
      "carrier_id": "aed2a8c0-7998-4fef-9a82-2cab5f527dc2",
      "countries": [
        "CA",
        "MX",
        "US"
      ],
      "credential_requirements": {},
      "document_types": [
        "bill_of_lading",
        "delivery_receipt"
      ],
      "features": [
        "auto_pro",
        "documents",
        "quote",
        "scheduled_pickup",
        "spot_quote",
        "tracking"
      ],
      "name": "Test Carrier",
      "options": [
        {
          "attributes": {
            "name": {
              "title": "Emergency Contact Name",
              "type": "string"
            },
            "phone": {
              "pattern": "([0-9]{10})",
              "title": "Emergency Contact Phone Number",
              "type": "string"
            }
          },
          "code": "haz",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Hazardous material"
        },
        {
          "attributes": null,
          "code": "ipu",
          "features": [
            "quote",
            "spot_quote"
          ],
          "name": "Inside pickup"
        },
        {
          "attributes": null,
          "code": "lftp",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Lift gate required at pickup"
        },
        {
          "attributes": null,
          "code": "rep",
          "features": [
            "quote",
            "spot_quote"
          ],
          "name": "Residential pickup"
        }
      ],
      "packages": [
        {
          "code": "bag",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Bag"
        },
        {
          "code": "pal",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Pail"
        },
        {
          "code": "pcs",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Piece"
        },
        {
          "code": "pkg",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Package"
        },
        {
          "code": "skd",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Skid"
        }
      ],
      "scac": "FAIL",
      "services": [
        {
          "code": "gtd_am",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Guaranteed Morning"
        },
        {
          "code": "gtd_noon",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Guaranteed Noon"
        },
        {
          "code": "gtd_pm",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Guaranteed End of Day"
        },
        {
          "code": "stnd",
          "features": [
            "quote",
            "spot_quote",
            "scheduled_pickup"
          ],
          "name": "Standard"
        }
      ]
    }
  ]
}