Site Logo

Get a Single Carrier

Example

GET /v1/carriers/:carrier_id

Example Request

1
2
3
GET /v1/carriers/se-123890 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
{
"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,
"services": [
{
"carrier_id": "se-123890",
"carrier_code": "stamps_com",
"service_code": "usps_first_class_mail",
"name": "USPS First Class Mail",
"domestic": true,
"international": false
},
{
"carrier_id": "se-123890",
"carrier_code": "stamps_com",
"service_code": "usps_media_mail",
"name": "USPS Media Mail",
"domestic": true,
"international": false
},
{
"carrier_id": "se-123890",
"carrier_code": "stamps_com",
"service_code": "usps_parcel_select",
"name": "USPS Parcel Select Ground",
"domestic": true,
"international": false
},
{
"carrier_id": "se-123890",
"carrier_code": "stamps_com",
"service_code": "usps_priority_mail",
"name": "USPS Priority Mail",
"domestic": true,
"international": false
},
{
"carrier_id": "se-123890",
"carrier_code": "stamps_com",
"service_code": "usps_priority_mail_express",
"name": "USPS Priority Mail Express",
"domestic": true,
"international": 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
},
{
"carrier_id": "se-123890",
"carrier_code": "stamps_com",
"service_code": "usps_priority_mail_international",
"name": "USPS Priority Mail Intl",
"domestic": false,
"international": true
},
{
"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
}
],
"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": []
}