List a Single LTL Carrier

This 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.

To list the details for all carriers, use the list connected LTL carrier call.

Requirements

The unique carrier_id for your LTL carrier account in ShipStation API.

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

Container Types & 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 ShipStation API, when you see package, this refers to the LTL shipper's container type offerings. Likewise, accessorial services are simply referred to as options in ShipStation API.

Example Request & Response

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

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"
        }
      ]
    }
  ]
}