List Carriers

This API endpoint returns a list of all your connected carrier accounts, along with helpful information about each account, its options, the services it offers, etc.

Carrier IDs

Each of your carriers has a unique carrier_id. You can use the carrier_id for many other ShipEngine endpoints to indicate which account to use.

For example, when creating a label, you can explicitly specify the carrier_id that you want to use. This is especially important if you have multiple accounts for the same carrier. Similarly, when calculating shipping costs, you may want to specify the carrier_id of the account that you know has the best discounts for the type of package.

Example

GET /v1/carriers/

Example Request

1
2
3
GET /v1/carriers 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
163
164
165
166
167
168
169
170
171
172
{
  "carriers": [
    {
      "carrier_id": "se-123890",
      "carrier_code": "stamps_com",
      "account_number": null,
      "requires_funded_amount": true,
      "balance": 0.0,
      "nickname": "Free",
      "friendly_name": "Stamps.com",
      "primary": true,
      "has_multi_package_supporting_services": false,
      "services": [
        {
          "carrier_id": "se-123890",
          "carrier_code": "stamps_com",
          "service_code": "usps_first_class_mail",
          "name": "USPS First Class Mail",
          "domestic": true,
          "international": false,
          "is_multi_package_supported": false
        },
        {
          "carrier_id": "se-123890",
          "carrier_code": "stamps_com",
          "service_code": "usps_media_mail",
          "name": "USPS Media Mail",
          "domestic": true,
          "international": false,
          "is_multi_package_supported": false
        },
        {
          "carrier_id": "se-123890",
          "carrier_code": "stamps_com",
          "service_code": "usps_parcel_select",
          "name": "USPS Parcel Select Ground",
          "domestic": true,
          "international": false,
          "is_multi_package_supported": false
        },
        {
          "carrier_id": "se-123890",
          "carrier_code": "stamps_com",
          "service_code": "usps_priority_mail",
          "name": "USPS Priority Mail",
          "domestic": true,
          "international": false,
          "is_multi_package_supported": false
        },
        {
          "carrier_id": "se-123890",
          "carrier_code": "stamps_com",
          "service_code": "usps_priority_mail_express",
          "name": "USPS Priority Mail Express",
          "domestic": true,
          "international": false,
          "is_multi_package_supported": false
        },
        {
          "carrier_id": "se-123890",
          "carrier_code": "stamps_com",
          "service_code": "usps_first_class_mail_international",
          "name": "USPS First Class Mail Intl",
          "domestic": false,
          "international": true,
          "is_multi_package_supported": false
        },
        {
          "carrier_id": "se-123890",
          "carrier_code": "stamps_com",
          "service_code": "usps_priority_mail_international",
          "name": "USPS Priority Mail Intl",
          "domestic": false,
          "international": true,
          "is_multi_package_supported": false
        },
        {
          "carrier_id": "se-123890",
          "carrier_code": "stamps_com",
          "service_code": "usps_priority_mail_express_international",
          "name": "USPS Priority Mail Express Intl",
          "domestic": false,
          "international": true,
          "is_multi_package_supported": false
        }
      ],
      "packages": [
        {
          "package_id": null,
          "package_code": "flat_rate_envelope",
          "name": "Flat Rate Envelope",
          "description": "USPS flat rate envelope. A special cardboard envelope provided by the USPS that clearly indicates Flat Rate."
        },
        {
          "package_id": null,
          "package_code": "flat_rate_legal_envelope",
          "name": "Flat Rate Legal Envelope",
          "description": "Flat Rate Legal Envelope"
        },
        {
          "package_id": null,
          "package_code": "flat_rate_padded_envelope",
          "name": "Flat Rate Padded Envelope",
          "description": "Flat Rate Padded Envelope"
        },
        {
          "package_id": null,
          "package_code": "large_envelope_or_flat",
          "name": "Large Envelope or Flat",
          "description": "Large envelope or flat. Has one dimension that is between 11 1/2 and 15 long, 6 1/18 and 12 high, or 1/4 and 3/4 thick."
        },
        {
          "package_id": null,
          "package_code": "large_flat_rate_box",
          "name": "Large Flat Rate Box",
          "description": "Large Flat Rate Box"
        },
        {
          "package_id": null,
          "package_code": "large_package",
          "name": "Large Package (any side > 12)",
          "description": "Large package. Longest side plus the distance around the thickest part is over 84 and less than or equal to 108."
        },
        {
          "package_id": null,
          "package_code": "letter",
          "name": "Letter",
          "description": "Letter"
        },
        {
          "package_id": null,
          "package_code": "medium_flat_rate_box",
          "name": "Medium Flat Rate Box",
          "description": "USPS flat rate box. A special 11 x 8 1/2 x 5 1/2 or 14 x 3.5 x 12 USPS box that clearly indicates Flat Rate Box"
        },
        {
          "package_id": null,
          "package_code": "package",
          "name": "Package",
          "description": "Package. Longest side plus the distance around the thickest part is less than or equal to 84"
        },
        {
          "package_id": null,
          "package_code": "regional_rate_box_a",
          "name": "Regional Rate Box A",
          "description": "Regional Rate Box A"
        },
        {
          "package_id": null,
          "package_code": "regional_rate_box_b",
          "name": "Regional Rate Box B",
          "description": "Regional Rate Box B"
        },
        {
          "package_id": null,
          "package_code": "small_flat_rate_box",
          "name": "Small Flat Rate Box",
          "description": "Small Flat Rate Box"
        },
        {
          "package_id": null,
          "package_code": "thick_envelope",
          "name": "Thick Envelope",
          "description": "Thick envelope. Envelopes or flats greater than 3/4 at the thickest point."
        }
      ],
      "options": []
    }
  ],
  "request_id": "fd27e4f2-4dfb-4963-ad46-e6b4f1658439",
  "errors": []
}

If you need to be explicit about these, make sure to pay attention to the carrier_id line.

1
2
3
{
  "carrier_id": "se-123890"
}