Order
Important: This endpoint only works with the following carriers:
- AustraliaPost
- DHLExpress
- DPD
- DPDUK
- Fastway
- FedEx
- UPS
- Purolator
The Order
object represents a collection of packages and is intended only for multi-parcel shipping; please use Shipments
for single-parcel shipping.
Like a single Shipment
, each Order
consists of a to_address
and from_address
, to be used for each Shipment
within the Order
.
These Address
objects will be copied to each Shipment
, so there is no need to specify them multiple times.
Each Shipment
must then specify its Parcel
, Options
, and CustomsInfo
.
Note: The customs_info
field within the Order
object is no longer used.
Always specify CustomsInfo
within each
Shipment
instead.
An Order
created with a valid Address
pair and Parcel
nested within the Order
's Shipment
object will automatically retrieve available shipping Rate
options.
id
in other API endpointsfrom_address
to_address
customs_info
field at the order level is deprecated and should not be used. SpecifyCustomsInfo
within each individualShipment
object instead.true
to create as a return.Order
was createdOrder
was last updated{
"mode": "test",
"reference": "",
"is_return": false,
"options": {
"currency": "USD",
"payment": {
"type": "SENDER"
}
},
"messages": [],
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"customs_info": null,
"from_address": {
"id": "adr_e51506082d1611f0b9823cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:00+00:00",
"name": "EasyPost",
"company": null,
"street1": "417 Montgomery Street",
"street2": "5th Floor",
"city": "San Francisco",
"state": "CA",
"zip": "94104",
"country": "US",
"phone": "4153334445",
"email": "support@easypost.com",
"mode": "test",
"carrier_facility": null,
"residential": null,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {}
},
"to_address": {
"id": "adr_e51381df2d1611f0b9803cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:01+00:00",
"name": "DR. STEVE BRULE",
"company": null,
"street1": "179 N HARBOR DR",
"street2": "",
"city": "REDONDO BEACH",
"state": "CA",
"zip": "90277-2506",
"country": "US",
"phone": "8573875756",
"email": "DR_STEVE_BRULE@GMAIL.COM",
"mode": "test",
"carrier_facility": null,
"residential": false,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {
"zip4": {
"success": true,
"errors": [],
"details": null
},
"delivery": {
"success": true,
"errors": [],
"details": {
"latitude": 33.8436,
"longitude": -118.39177,
"time_zone": "America/Los_Angeles"
}
}
}
},
"buyer_address": {
"id": "adr_e51381df2d1611f0b9803cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:01+00:00",
"name": "DR. STEVE BRULE",
"company": null,
"street1": "179 N HARBOR DR",
"street2": "",
"city": "REDONDO BEACH",
"state": "CA",
"zip": "90277-2506",
"country": "US",
"phone": "8573875756",
"email": "DR_STEVE_BRULE@GMAIL.COM",
"mode": "test",
"carrier_facility": null,
"residential": false,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {
"zip4": {
"success": true,
"errors": [],
"details": null
},
"delivery": {
"success": true,
"errors": [],
"details": {
"latitude": 33.8436,
"longitude": -118.39177,
"time_zone": "America/Los_Angeles"
}
}
}
},
"return_address": {
"id": "adr_e51506082d1611f0b9823cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:00+00:00",
"name": "EasyPost",
"company": null,
"street1": "417 Montgomery Street",
"street2": "5th Floor",
"city": "San Francisco",
"state": "CA",
"zip": "94104",
"country": "US",
"phone": "4153334445",
"email": "support@easypost.com",
"mode": "test",
"carrier_facility": null,
"residential": null,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {}
},
"shipments": [
{
"id": "shp_dc956f485e2540889b7f7eab7d668b88",
"created_at": "2025-05-09T20:48:00Z",
"is_return": false,
"messages": [],
"mode": "test",
"options": {
"currency": "USD",
"payment": {
"type": "SENDER"
},
"date_advance": 0
},
"reference": null,
"status": "unknown",
"tracking_code": "9400100208303109837512",
"updated_at": "2025-05-09T20:48:01Z",
"batch_id": null,
"batch_status": null,
"batch_message": null,
"customs_info": null,
"from_address": {
"id": "adr_e51506082d1611f0b9823cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:00+00:00",
"name": "EasyPost",
"company": null,
"street1": "417 Montgomery Street",
"street2": "5th Floor",
"city": "San Francisco",
"state": "CA",
"zip": "94104",
"country": "US",
"phone": "4153334445",
"email": "support@easypost.com",
"mode": "test",
"carrier_facility": null,
"residential": null,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {}
},
"insurance": null,
"order_id": "order_dae84134c5d54a01a57ff6eab32c34a2",
"parcel": {
"id": "prcl_dbd3f85ebce547f3baf9285545bc86cf",
"object": "Parcel",
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"length": null,
"width": null,
"height": null,
"predefined_package": null,
"weight": 10.2,
"mode": "test"
},
"postage_label": {
"object": "PostageLabel",
"id": "pl_ec778bac45c848ffb010782a8ac9d794",
"created_at": "2025-05-09T20:48:01Z",
"updated_at": "2025-05-09T20:48:01Z",
"date_advance": 0,
"integrated_form": "none",
"label_date": "2025-05-09T20:48:01Z",
"label_resolution": 300,
"label_size": "4x6",
"label_type": "default",
"label_file_type": "image/png",
"label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250509/e811f9e30a55d8495691c382633bd1de27.png",
"label_pdf_url": null,
"label_zpl_url": null,
"label_epl2_url": null,
"label_file": null
},
"rates": [
{
"id": "rate_76b94a6a12e4451ebd2c83d643499e52",
"object": "Rate",
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"mode": "test",
"service": "Express",
"carrier": "USPS",
"rate": "34.15",
"currency": "USD",
"retail_rate": "39.10",
"retail_currency": "USD",
"list_rate": "34.15",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 2,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 2,
"shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
},
{
"id": "rate_f5162cf3d5404cde8b9152111f35f691",
"object": "Rate",
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"mode": "test",
"service": "Priority",
"carrier": "USPS",
"rate": "7.42",
"currency": "USD",
"retail_rate": "9.90",
"retail_currency": "USD",
"list_rate": "8.34",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 2,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 2,
"shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
},
{
"id": "rate_d7494d4d8044411ab025bf44a7bb5400",
"object": "Rate",
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"mode": "test",
"service": "GroundAdvantage",
"carrier": "USPS",
"rate": "5.21",
"currency": "USD",
"retail_rate": "7.00",
"retail_currency": "USD",
"list_rate": "5.21",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 3,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 3,
"shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
}
],
"refund_status": null,
"scan_form": null,
"selected_rate": {
"id": "rate_d7494d4d8044411ab025bf44a7bb5400",
"object": "Rate",
"created_at": "2025-05-09T20:48:01Z",
"updated_at": "2025-05-09T20:48:01Z",
"mode": "test",
"service": "GroundAdvantage",
"carrier": "USPS",
"rate": "5.21",
"currency": "USD",
"retail_rate": "7.00",
"retail_currency": "USD",
"list_rate": "5.21",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 3,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 3,
"shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
},
"tracker": {
"id": "trk_82b8af6bc0ed482f957360e0a592caaa",
"object": "Tracker",
"mode": "test",
"tracking_code": "9400100208303109837512",
"status": "unknown",
"status_detail": "unknown",
"created_at": "2025-05-09T20:48:02Z",
"updated_at": "2025-05-09T20:48:02Z",
"signed_by": null,
"weight": null,
"est_delivery_date": null,
"shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
"carrier": "USPS",
"tracking_details": [],
"fees": [],
"carrier_detail": null,
"public_url": "https://track.easypost.com/djE6dHJrXzgyYjhhZjZiYzBlZDQ4MmY5NTczNjBlMGE1OTJjYWFh"
},
"to_address": {
"id": "adr_e51381df2d1611f0b9803cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:01+00:00",
"name": "DR. STEVE BRULE",
"company": null,
"street1": "179 N HARBOR DR",
"street2": "",
"city": "REDONDO BEACH",
"state": "CA",
"zip": "90277-2506",
"country": "US",
"phone": "8573875756",
"email": "DR_STEVE_BRULE@GMAIL.COM",
"mode": "test",
"carrier_facility": null,
"residential": false,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {
"zip4": {
"success": true,
"errors": [],
"details": null
},
"delivery": {
"success": true,
"errors": [],
"details": {
"latitude": 33.8436,
"longitude": -118.39177,
"time_zone": "America/Los_Angeles"
}
}
}
},
"usps_zone": 4,
"return_address": {
"id": "adr_e51506082d1611f0b9823cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:00+00:00",
"name": "EasyPost",
"company": null,
"street1": "417 Montgomery Street",
"street2": "5th Floor",
"city": "San Francisco",
"state": "CA",
"zip": "94104",
"country": "US",
"phone": "4153334445",
"email": "support@easypost.com",
"mode": "test",
"carrier_facility": null,
"residential": null,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {}
},
"buyer_address": {
"id": "adr_e51381df2d1611f0b9803cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:01+00:00",
"name": "DR. STEVE BRULE",
"company": null,
"street1": "179 N HARBOR DR",
"street2": "",
"city": "REDONDO BEACH",
"state": "CA",
"zip": "90277-2506",
"country": "US",
"phone": "8573875756",
"email": "DR_STEVE_BRULE@GMAIL.COM",
"mode": "test",
"carrier_facility": null,
"residential": false,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {
"zip4": {
"success": true,
"errors": [],
"details": null
},
"delivery": {
"success": true,
"errors": [],
"details": {
"latitude": 33.8436,
"longitude": -118.39177,
"time_zone": "America/Los_Angeles"
}
}
}
},
"forms": [],
"fees": [
{
"object": "Fee",
"type": "PostageFee",
"amount": "5.21000",
"charged": true,
"refunded": false
}
],
"object": "Shipment"
},
{
"id": "shp_fe48581e16154012b1e51ad5606d34c1",
"created_at": "2025-05-09T20:48:00Z",
"is_return": false,
"messages": [],
"mode": "test",
"options": {
"currency": "USD",
"payment": {
"type": "SENDER"
},
"date_advance": 0
},
"reference": null,
"status": "unknown",
"tracking_code": "9434600208303109842303",
"updated_at": "2025-05-09T20:48:02Z",
"batch_id": null,
"batch_status": null,
"batch_message": null,
"customs_info": null,
"from_address": {
"id": "adr_e51506082d1611f0b9823cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:00+00:00",
"name": "EasyPost",
"company": null,
"street1": "417 Montgomery Street",
"street2": "5th Floor",
"city": "San Francisco",
"state": "CA",
"zip": "94104",
"country": "US",
"phone": "4153334445",
"email": "support@easypost.com",
"mode": "test",
"carrier_facility": null,
"residential": null,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {}
},
"insurance": null,
"order_id": "order_dae84134c5d54a01a57ff6eab32c34a2",
"parcel": {
"id": "prcl_69844696fd314ceeb78bb9969034a102",
"object": "Parcel",
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"length": null,
"width": null,
"height": null,
"predefined_package": null,
"weight": 17.5,
"mode": "test"
},
"postage_label": {
"object": "PostageLabel",
"id": "pl_417029731e9d45c8b7e2750043a3517d",
"created_at": "2025-05-09T20:48:01Z",
"updated_at": "2025-05-09T20:48:02Z",
"date_advance": 0,
"integrated_form": "none",
"label_date": "2025-05-09T20:48:01Z",
"label_resolution": 300,
"label_size": "4x6",
"label_type": "default",
"label_file_type": "image/png",
"label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250509/e864b415157bbf4709a37a07e9a5cd1550.png",
"label_pdf_url": null,
"label_zpl_url": null,
"label_epl2_url": null,
"label_file": null
},
"rates": [
{
"id": "rate_cc10630499d943208164f119319612a2",
"object": "Rate",
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"mode": "test",
"service": "Priority",
"carrier": "USPS",
"rate": "8.22",
"currency": "USD",
"retail_rate": "12.65",
"retail_currency": "USD",
"list_rate": "9.07",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 2,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 2,
"shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
},
{
"id": "rate_270b4cbb74434de5883abdd54d308788",
"object": "Rate",
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"mode": "test",
"service": "GroundAdvantage",
"carrier": "USPS",
"rate": "6.53",
"currency": "USD",
"retail_rate": "11.40",
"retail_currency": "USD",
"list_rate": "8.05",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 3,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 3,
"shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
},
{
"id": "rate_5ec54c14e6a147ada7d670f294a40a1b",
"object": "Rate",
"created_at": "2025-05-09T20:48:00Z",
"updated_at": "2025-05-09T20:48:00Z",
"mode": "test",
"service": "Express",
"carrier": "USPS",
"rate": "38.40",
"currency": "USD",
"retail_rate": "44.15",
"retail_currency": "USD",
"list_rate": "38.40",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 2,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 2,
"shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
}
],
"refund_status": null,
"scan_form": null,
"selected_rate": {
"id": "rate_270b4cbb74434de5883abdd54d308788",
"object": "Rate",
"created_at": "2025-05-09T20:48:01Z",
"updated_at": "2025-05-09T20:48:01Z",
"mode": "test",
"service": "GroundAdvantage",
"carrier": "USPS",
"rate": "6.53",
"currency": "USD",
"retail_rate": "11.40",
"retail_currency": "USD",
"list_rate": "8.05",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 3,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 3,
"shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
},
"tracker": {
"id": "trk_545fffdf10084dab8a56046d00b08ad7",
"object": "Tracker",
"mode": "test",
"tracking_code": "9434600208303109842303",
"status": "unknown",
"status_detail": "unknown",
"created_at": "2025-05-09T20:48:02Z",
"updated_at": "2025-05-09T20:48:02Z",
"signed_by": null,
"weight": null,
"est_delivery_date": null,
"shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
"carrier": "USPS",
"tracking_details": [],
"fees": [],
"carrier_detail": null,
"public_url": "https://track.easypost.com/djE6dHJrXzU0NWZmZmRmMTAwODRkYWI4YTU2MDQ2ZDAwYjA4YWQ3"
},
"to_address": {
"id": "adr_e51381df2d1611f0b9803cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:01+00:00",
"name": "DR. STEVE BRULE",
"company": null,
"street1": "179 N HARBOR DR",
"street2": "",
"city": "REDONDO BEACH",
"state": "CA",
"zip": "90277-2506",
"country": "US",
"phone": "8573875756",
"email": "DR_STEVE_BRULE@GMAIL.COM",
"mode": "test",
"carrier_facility": null,
"residential": false,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {
"zip4": {
"success": true,
"errors": [],
"details": null
},
"delivery": {
"success": true,
"errors": [],
"details": {
"latitude": 33.8436,
"longitude": -118.39177,
"time_zone": "America/Los_Angeles"
}
}
}
},
"usps_zone": 4,
"return_address": {
"id": "adr_e51506082d1611f0b9823cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:00+00:00",
"name": "EasyPost",
"company": null,
"street1": "417 Montgomery Street",
"street2": "5th Floor",
"city": "San Francisco",
"state": "CA",
"zip": "94104",
"country": "US",
"phone": "4153334445",
"email": "support@easypost.com",
"mode": "test",
"carrier_facility": null,
"residential": null,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {}
},
"buyer_address": {
"id": "adr_e51381df2d1611f0b9803cecef1b359e",
"object": "Address",
"created_at": "2025-05-09T20:48:00+00:00",
"updated_at": "2025-05-09T20:48:01+00:00",
"name": "DR. STEVE BRULE",
"company": null,
"street1": "179 N HARBOR DR",
"street2": "",
"city": "REDONDO BEACH",
"state": "CA",
"zip": "90277-2506",
"country": "US",
"phone": "8573875756",
"email": "DR_STEVE_BRULE@GMAIL.COM",
"mode": "test",
"carrier_facility": null,
"residential": false,
"federal_tax_id": null,
"state_tax_id": null,
"verifications": {
"zip4": {
"success": true,
"errors": [],
"details": null
},
"delivery": {
"success": true,
"errors": [],
"details": {
"latitude": 33.8436,
"longitude": -118.39177,
"time_zone": "America/Los_Angeles"
}
}
}
},
"forms": [],
"fees": [
{
"object": "Fee",
"type": "PostageFee",
"amount": "6.53000",
"charged": true,
"refunded": false
}
],
"object": "Shipment"
}
],
"rates": [
{
"id": "rate_76b94a6a12e4451ebd2c83d643499e52",
"object": "Rate",
"created_at": null,
"updated_at": null,
"mode": "test",
"service": "Express",
"carrier": "USPS",
"rate": "72.55",
"currency": "USD",
"retail_rate": "83.25",
"retail_currency": "USD",
"list_rate": "72.55",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 2,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 2,
"shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
},
{
"id": "rate_f5162cf3d5404cde8b9152111f35f691",
"object": "Rate",
"created_at": null,
"updated_at": null,
"mode": "test",
"service": "Priority",
"carrier": "USPS",
"rate": "15.64",
"currency": "USD",
"retail_rate": "22.55",
"retail_currency": "USD",
"list_rate": "17.41",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 2,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 2,
"shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
},
{
"id": "rate_d7494d4d8044411ab025bf44a7bb5400",
"object": "Rate",
"created_at": null,
"updated_at": null,
"mode": "test",
"service": "GroundAdvantage",
"carrier": "USPS",
"rate": "11.74",
"currency": "USD",
"retail_rate": "18.40",
"retail_currency": "USD",
"list_rate": "13.26",
"list_currency": "USD",
"billing_type": "easypost",
"delivery_days": 3,
"delivery_date": null,
"delivery_date_guaranteed": false,
"est_delivery_days": 3,
"shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
"carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
}
],
"id": "order_dae84134c5d54a01a57ff6eab32c34a2",
"object": "Order"
}
Creating an Order
is intended only for multi-parcel shipping; please use Shipments
for single-parcel shipping.
An Order
is almost exclusively a container for other objects, and thus an Order
may reuse many of these objects.
Alternatively, all the objects contained within an Order
may be created at the same time.
You can limit the CarrierAccounts
to use for rating by passing the carrier_accounts
parameter.
An Order object is immutable once created. All information must be provided during creation; it cannot be modified later.
Request Parameters
Address
Shipment
array1curl -X POST https://api.easypost.com/v2/orders \
2 -u "EASYPOST_API_KEY": \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "order": {
6 "to_address": {
7 "id": "adr_..."
8 },
9 "from_address": {
10 "id": "adr_..."
11 },
12 "shipments": [
13 {
14 "parcel": {
15 "weight": "10.2"
16 }
17 },
18 {
19 "parcel": {
20 "predefined_package": "FedExBox",
21 "weight": "17.5"
22 }
23 }
24 ]
25 }
26 }'
1{
2 "mode": "test",
3 "reference": "",
4 "is_return": false,
5 "options": {
6 "currency": "USD",
7 "payment": {
8 "type": "SENDER"
9 }
10 },
11 "messages": [],
12 "created_at": "2025-05-09T20:47:59Z",
13 "updated_at": "2025-05-09T20:47:59Z",
14 "customs_info": null,
15 "from_address": {
16 "id": "adr_e476e5f52d1611f0b8e43cecef1b359e",
17 "object": "Address",
18 "created_at": "2025-05-09T20:47:59+00:00",
19 "updated_at": "2025-05-09T20:47:59+00:00",
20 "name": "EasyPost",
21 "company": null,
22 "street1": "417 Montgomery Street",
23 "street2": "5th Floor",
24 "city": "San Francisco",
25 "state": "CA",
26 "zip": "94104",
27 "country": "US",
28 "phone": "4153334445",
29 "email": "support@easypost.com",
30 "mode": "test",
31 "carrier_facility": null,
32 "residential": null,
33 "federal_tax_id": null,
34 "state_tax_id": null,
35 "verifications": {}
36 },
37 "to_address": {
38 "id": "adr_e474df1f2d1611f0b8e33cecef1b359e",
39 "object": "Address",
40 "created_at": "2025-05-09T20:47:59+00:00",
41 "updated_at": "2025-05-09T20:47:59+00:00",
42 "name": "Dr. Steve Brule",
43 "company": null,
44 "street1": "179 N Harbor Dr",
45 "street2": null,
46 "city": "Redondo Beach",
47 "state": "CA",
48 "zip": "90277",
49 "country": "US",
50 "phone": "8573875756",
51 "email": "dr_steve_brule@gmail.com",
52 "mode": "test",
53 "carrier_facility": null,
54 "residential": null,
55 "federal_tax_id": null,
56 "state_tax_id": null,
57 "verifications": {}
58 },
59 "buyer_address": {
60 "id": "adr_e474df1f2d1611f0b8e33cecef1b359e",
61 "object": "Address",
62 "created_at": "2025-05-09T20:47:59+00:00",
63 "updated_at": "2025-05-09T20:47:59+00:00",
64 "name": "Dr. Steve Brule",
65 "company": null,
66 "street1": "179 N Harbor Dr",
67 "street2": null,
68 "city": "Redondo Beach",
69 "state": "CA",
70 "zip": "90277",
71 "country": "US",
72 "phone": "8573875756",
73 "email": "dr_steve_brule@gmail.com",
74 "mode": "test",
75 "carrier_facility": null,
76 "residential": null,
77 "federal_tax_id": null,
78 "state_tax_id": null,
79 "verifications": {}
80 },
81 "return_address": {
82 "id": "adr_e476e5f52d1611f0b8e43cecef1b359e",
83 "object": "Address",
84 "created_at": "2025-05-09T20:47:59+00:00",
85 "updated_at": "2025-05-09T20:47:59+00:00",
86 "name": "EasyPost",
87 "company": null,
88 "street1": "417 Montgomery Street",
89 "street2": "5th Floor",
90 "city": "San Francisco",
91 "state": "CA",
92 "zip": "94104",
93 "country": "US",
94 "phone": "4153334445",
95 "email": "support@easypost.com",
96 "mode": "test",
97 "carrier_facility": null,
98 "residential": null,
99 "federal_tax_id": null,
100 "state_tax_id": null,
101 "verifications": {}
102 },
103 "shipments": [
104 {
105 "id": "shp_6a74ecd236cd4ce2abfda24c65cb1bf4",
106 "created_at": "2025-05-09T20:47:59Z",
107 "is_return": false,
108 "messages": [],
109 "mode": "test",
110 "options": {
111 "currency": "USD",
112 "payment": {
113 "type": "SENDER"
114 },
115 "date_advance": 0
116 },
117 "reference": null,
118 "status": "unknown",
119 "tracking_code": null,
120 "updated_at": "2025-05-09T20:47:59Z",
121 "batch_id": null,
122 "batch_status": null,
123 "batch_message": null,
124 "customs_info": null,
125 "from_address": {
126 "id": "adr_e476e5f52d1611f0b8e43cecef1b359e",
127 "object": "Address",
128 "created_at": "2025-05-09T20:47:59+00:00",
129 "updated_at": "2025-05-09T20:47:59+00:00",
130 "name": "EasyPost",
131 "company": null,
132 "street1": "417 Montgomery Street",
133 "street2": "5th Floor",
134 "city": "San Francisco",
135 "state": "CA",
136 "zip": "94104",
137 "country": "US",
138 "phone": "4153334445",
139 "email": "support@easypost.com",
140 "mode": "test",
141 "carrier_facility": null,
142 "residential": null,
143 "federal_tax_id": null,
144 "state_tax_id": null,
145 "verifications": {}
146 },
147 "insurance": null,
148 "order_id": "order_bf861ee184c74e7fadc4d85c6ed435d1",
149 "parcel": {
150 "id": "prcl_a1a01a63ad9446de982011a5c57749f5",
151 "object": "Parcel",
152 "created_at": "2025-05-09T20:47:59Z",
153 "updated_at": "2025-05-09T20:47:59Z",
154 "length": null,
155 "width": null,
156 "height": null,
157 "predefined_package": null,
158 "weight": 10.2,
159 "mode": "test"
160 },
161 "postage_label": null,
162 "rates": [
163 {
164 "id": "rate_dcc6f56355c24ffea3f1a05b8b02b0f9",
165 "object": "Rate",
166 "created_at": "2025-05-09T20:47:59Z",
167 "updated_at": "2025-05-09T20:47:59Z",
168 "mode": "test",
169 "service": "Express",
170 "carrier": "USPS",
171 "rate": "34.15",
172 "currency": "USD",
173 "retail_rate": "39.10",
174 "retail_currency": "USD",
175 "list_rate": "34.15",
176 "list_currency": "USD",
177 "billing_type": "easypost",
178 "delivery_days": 2,
179 "delivery_date": null,
180 "delivery_date_guaranteed": false,
181 "est_delivery_days": 2,
182 "shipment_id": "shp_6a74ecd236cd4ce2abfda24c65cb1bf4",
183 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
184 },
185 {
186 "id": "rate_3377badbf52940ada050d1b55b836842",
187 "object": "Rate",
188 "created_at": "2025-05-09T20:47:59Z",
189 "updated_at": "2025-05-09T20:47:59Z",
190 "mode": "test",
191 "service": "Priority",
192 "carrier": "USPS",
193 "rate": "7.42",
194 "currency": "USD",
195 "retail_rate": "9.90",
196 "retail_currency": "USD",
197 "list_rate": "8.34",
198 "list_currency": "USD",
199 "billing_type": "easypost",
200 "delivery_days": 2,
201 "delivery_date": null,
202 "delivery_date_guaranteed": false,
203 "est_delivery_days": 2,
204 "shipment_id": "shp_6a74ecd236cd4ce2abfda24c65cb1bf4",
205 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
206 },
207 {
208 "id": "rate_54f8543f09494ab49327832fd833f33a",
209 "object": "Rate",
210 "created_at": "2025-05-09T20:47:59Z",
211 "updated_at": "2025-05-09T20:47:59Z",
212 "mode": "test",
213 "service": "GroundAdvantage",
214 "carrier": "USPS",
215 "rate": "5.21",
216 "currency": "USD",
217 "retail_rate": "7.00",
218 "retail_currency": "USD",
219 "list_rate": "5.21",
220 "list_currency": "USD",
221 "billing_type": "easypost",
222 "delivery_days": 3,
223 "delivery_date": null,
224 "delivery_date_guaranteed": false,
225 "est_delivery_days": 3,
226 "shipment_id": "shp_6a74ecd236cd4ce2abfda24c65cb1bf4",
227 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
228 }
229 ],
230 "refund_status": null,
231 "scan_form": null,
232 "selected_rate": null,
233 "tracker": null,
234 "to_address": {
235 "id": "adr_e474df1f2d1611f0b8e33cecef1b359e",
236 "object": "Address",
237 "created_at": "2025-05-09T20:47:59+00:00",
238 "updated_at": "2025-05-09T20:47:59+00:00",
239 "name": "Dr. Steve Brule",
240 "company": null,
241 "street1": "179 N Harbor Dr",
242 "street2": null,
243 "city": "Redondo Beach",
244 "state": "CA",
245 "zip": "90277",
246 "country": "US",
247 "phone": "8573875756",
248 "email": "dr_steve_brule@gmail.com",
249 "mode": "test",
250 "carrier_facility": null,
251 "residential": null,
252 "federal_tax_id": null,
253 "state_tax_id": null,
254 "verifications": {}
255 },
256 "usps_zone": 4,
257 "return_address": {
258 "id": "adr_e476e5f52d1611f0b8e43cecef1b359e",
259 "object": "Address",
260 "created_at": "2025-05-09T20:47:59+00:00",
261 "updated_at": "2025-05-09T20:47:59+00:00",
262 "name": "EasyPost",
263 "company": null,
264 "street1": "417 Montgomery Street",
265 "street2": "5th Floor",
266 "city": "San Francisco",
267 "state": "CA",
268 "zip": "94104",
269 "country": "US",
270 "phone": "4153334445",
271 "email": "support@easypost.com",
272 "mode": "test",
273 "carrier_facility": null,
274 "residential": null,
275 "federal_tax_id": null,
276 "state_tax_id": null,
277 "verifications": {}
278 },
279 "buyer_address": {
280 "id": "adr_e474df1f2d1611f0b8e33cecef1b359e",
281 "object": "Address",
282 "created_at": "2025-05-09T20:47:59+00:00",
283 "updated_at": "2025-05-09T20:47:59+00:00",
284 "name": "Dr. Steve Brule",
285 "company": null,
286 "street1": "179 N Harbor Dr",
287 "street2": null,
288 "city": "Redondo Beach",
289 "state": "CA",
290 "zip": "90277",
291 "country": "US",
292 "phone": "8573875756",
293 "email": "dr_steve_brule@gmail.com",
294 "mode": "test",
295 "carrier_facility": null,
296 "residential": null,
297 "federal_tax_id": null,
298 "state_tax_id": null,
299 "verifications": {}
300 },
301 "forms": [],
302 "fees": [],
303 "object": "Shipment"
304 },
305 {
306 "id": "shp_9924d1743d8843e0bf6a1db2bd2ada36",
307 "created_at": "2025-05-09T20:47:59Z",
308 "is_return": false,
309 "messages": [],
310 "mode": "test",
311 "options": {
312 "currency": "USD",
313 "payment": {
314 "type": "SENDER"
315 },
316 "date_advance": 0
317 },
318 "reference": null,
319 "status": "unknown",
320 "tracking_code": null,
321 "updated_at": "2025-05-09T20:47:59Z",
322 "batch_id": null,
323 "batch_status": null,
324 "batch_message": null,
325 "customs_info": null,
326 "from_address": {
327 "id": "adr_e476e5f52d1611f0b8e43cecef1b359e",
328 "object": "Address",
329 "created_at": "2025-05-09T20:47:59+00:00",
330 "updated_at": "2025-05-09T20:47:59+00:00",
331 "name": "EasyPost",
332 "company": null,
333 "street1": "417 Montgomery Street",
334 "street2": "5th Floor",
335 "city": "San Francisco",
336 "state": "CA",
337 "zip": "94104",
338 "country": "US",
339 "phone": "4153334445",
340 "email": "support@easypost.com",
341 "mode": "test",
342 "carrier_facility": null,
343 "residential": null,
344 "federal_tax_id": null,
345 "state_tax_id": null,
346 "verifications": {}
347 },
348 "insurance": null,
349 "order_id": "order_bf861ee184c74e7fadc4d85c6ed435d1",
350 "parcel": {
351 "id": "prcl_9070a59bde1045e9ac355687266b0d01",
352 "object": "Parcel",
353 "created_at": "2025-05-09T20:47:59Z",
354 "updated_at": "2025-05-09T20:47:59Z",
355 "length": null,
356 "width": null,
357 "height": null,
358 "predefined_package": null,
359 "weight": 17.5,
360 "mode": "test"
361 },
362 "postage_label": null,
363 "rates": [
364 {
365 "id": "rate_de46ff4d823b4d7787659fa415a12771",
366 "object": "Rate",
367 "created_at": "2025-05-09T20:47:59Z",
368 "updated_at": "2025-05-09T20:47:59Z",
369 "mode": "test",
370 "service": "Priority",
371 "carrier": "USPS",
372 "rate": "8.22",
373 "currency": "USD",
374 "retail_rate": "12.65",
375 "retail_currency": "USD",
376 "list_rate": "9.07",
377 "list_currency": "USD",
378 "billing_type": "easypost",
379 "delivery_days": 2,
380 "delivery_date": null,
381 "delivery_date_guaranteed": false,
382 "est_delivery_days": 2,
383 "shipment_id": "shp_9924d1743d8843e0bf6a1db2bd2ada36",
384 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
385 },
386 {
387 "id": "rate_2418c9a1feac4015a2091d3a9804b8d7",
388 "object": "Rate",
389 "created_at": "2025-05-09T20:47:59Z",
390 "updated_at": "2025-05-09T20:47:59Z",
391 "mode": "test",
392 "service": "GroundAdvantage",
393 "carrier": "USPS",
394 "rate": "6.53",
395 "currency": "USD",
396 "retail_rate": "11.40",
397 "retail_currency": "USD",
398 "list_rate": "8.05",
399 "list_currency": "USD",
400 "billing_type": "easypost",
401 "delivery_days": 3,
402 "delivery_date": null,
403 "delivery_date_guaranteed": false,
404 "est_delivery_days": 3,
405 "shipment_id": "shp_9924d1743d8843e0bf6a1db2bd2ada36",
406 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
407 },
408 {
409 "id": "rate_62f9ac6737cc47a6b05601a371e68f81",
410 "object": "Rate",
411 "created_at": "2025-05-09T20:47:59Z",
412 "updated_at": "2025-05-09T20:47:59Z",
413 "mode": "test",
414 "service": "Express",
415 "carrier": "USPS",
416 "rate": "38.40",
417 "currency": "USD",
418 "retail_rate": "44.15",
419 "retail_currency": "USD",
420 "list_rate": "38.40",
421 "list_currency": "USD",
422 "billing_type": "easypost",
423 "delivery_days": 2,
424 "delivery_date": null,
425 "delivery_date_guaranteed": false,
426 "est_delivery_days": 2,
427 "shipment_id": "shp_9924d1743d8843e0bf6a1db2bd2ada36",
428 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
429 }
430 ],
431 "refund_status": null,
432 "scan_form": null,
433 "selected_rate": null,
434 "tracker": null,
435 "to_address": {
436 "id": "adr_e474df1f2d1611f0b8e33cecef1b359e",
437 "object": "Address",
438 "created_at": "2025-05-09T20:47:59+00:00",
439 "updated_at": "2025-05-09T20:47:59+00:00",
440 "name": "Dr. Steve Brule",
441 "company": null,
442 "street1": "179 N Harbor Dr",
443 "street2": null,
444 "city": "Redondo Beach",
445 "state": "CA",
446 "zip": "90277",
447 "country": "US",
448 "phone": "8573875756",
449 "email": "dr_steve_brule@gmail.com",
450 "mode": "test",
451 "carrier_facility": null,
452 "residential": null,
453 "federal_tax_id": null,
454 "state_tax_id": null,
455 "verifications": {}
456 },
457 "usps_zone": 4,
458 "return_address": {
459 "id": "adr_e476e5f52d1611f0b8e43cecef1b359e",
460 "object": "Address",
461 "created_at": "2025-05-09T20:47:59+00:00",
462 "updated_at": "2025-05-09T20:47:59+00:00",
463 "name": "EasyPost",
464 "company": null,
465 "street1": "417 Montgomery Street",
466 "street2": "5th Floor",
467 "city": "San Francisco",
468 "state": "CA",
469 "zip": "94104",
470 "country": "US",
471 "phone": "4153334445",
472 "email": "support@easypost.com",
473 "mode": "test",
474 "carrier_facility": null,
475 "residential": null,
476 "federal_tax_id": null,
477 "state_tax_id": null,
478 "verifications": {}
479 },
480 "buyer_address": {
481 "id": "adr_e474df1f2d1611f0b8e33cecef1b359e",
482 "object": "Address",
483 "created_at": "2025-05-09T20:47:59+00:00",
484 "updated_at": "2025-05-09T20:47:59+00:00",
485 "name": "Dr. Steve Brule",
486 "company": null,
487 "street1": "179 N Harbor Dr",
488 "street2": null,
489 "city": "Redondo Beach",
490 "state": "CA",
491 "zip": "90277",
492 "country": "US",
493 "phone": "8573875756",
494 "email": "dr_steve_brule@gmail.com",
495 "mode": "test",
496 "carrier_facility": null,
497 "residential": null,
498 "federal_tax_id": null,
499 "state_tax_id": null,
500 "verifications": {}
501 },
502 "forms": [],
503 "fees": [],
504 "object": "Shipment"
505 }
506 ],
507 "rates": [
508 {
509 "id": "rate_dcc6f56355c24ffea3f1a05b8b02b0f9",
510 "object": "Rate",
511 "created_at": null,
512 "updated_at": null,
513 "mode": "test",
514 "service": "Express",
515 "carrier": "USPS",
516 "rate": "72.55",
517 "currency": "USD",
518 "retail_rate": "83.25",
519 "retail_currency": "USD",
520 "list_rate": "72.55",
521 "list_currency": "USD",
522 "billing_type": "easypost",
523 "delivery_days": 2,
524 "delivery_date": null,
525 "delivery_date_guaranteed": false,
526 "est_delivery_days": 2,
527 "shipment_id": "shp_6a74ecd236cd4ce2abfda24c65cb1bf4",
528 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
529 },
530 {
531 "id": "rate_3377badbf52940ada050d1b55b836842",
532 "object": "Rate",
533 "created_at": null,
534 "updated_at": null,
535 "mode": "test",
536 "service": "Priority",
537 "carrier": "USPS",
538 "rate": "15.64",
539 "currency": "USD",
540 "retail_rate": "22.55",
541 "retail_currency": "USD",
542 "list_rate": "17.41",
543 "list_currency": "USD",
544 "billing_type": "easypost",
545 "delivery_days": 2,
546 "delivery_date": null,
547 "delivery_date_guaranteed": false,
548 "est_delivery_days": 2,
549 "shipment_id": "shp_6a74ecd236cd4ce2abfda24c65cb1bf4",
550 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
551 },
552 {
553 "id": "rate_54f8543f09494ab49327832fd833f33a",
554 "object": "Rate",
555 "created_at": null,
556 "updated_at": null,
557 "mode": "test",
558 "service": "GroundAdvantage",
559 "carrier": "USPS",
560 "rate": "11.74",
561 "currency": "USD",
562 "retail_rate": "18.40",
563 "retail_currency": "USD",
564 "list_rate": "13.26",
565 "list_currency": "USD",
566 "billing_type": "easypost",
567 "delivery_days": 3,
568 "delivery_date": null,
569 "delivery_date_guaranteed": false,
570 "est_delivery_days": 3,
571 "shipment_id": "shp_6a74ecd236cd4ce2abfda24c65cb1bf4",
572 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
573 }
574 ],
575 "id": "order_bf861ee184c74e7fadc4d85c6ed435d1",
576 "object": "Order"
577}
To purchase an Order
, you only need to specify the carrier
and service
. This operation populates the tracking_code
and postage_label
attributes of each Shipment
in the order.
Request Parameters
1curl -X POST https://api.easypost.com/v2/orders/order_.../buy \
2 -u "EASYPOST_API_KEY": \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "carrier": "FedEx",
6 "service": "FEDEX_GROUND"
7 }'
1{
2 "mode": "test",
3 "reference": "",
4 "is_return": false,
5 "options": {
6 "currency": "USD",
7 "payment": {
8 "type": "SENDER"
9 }
10 },
11 "messages": [],
12 "created_at": "2025-05-09T20:48:00Z",
13 "updated_at": "2025-05-09T20:48:00Z",
14 "customs_info": null,
15 "from_address": {
16 "id": "adr_e51506082d1611f0b9823cecef1b359e",
17 "object": "Address",
18 "created_at": "2025-05-09T20:48:00+00:00",
19 "updated_at": "2025-05-09T20:48:00+00:00",
20 "name": "EasyPost",
21 "company": null,
22 "street1": "417 Montgomery Street",
23 "street2": "5th Floor",
24 "city": "San Francisco",
25 "state": "CA",
26 "zip": "94104",
27 "country": "US",
28 "phone": "4153334445",
29 "email": "support@easypost.com",
30 "mode": "test",
31 "carrier_facility": null,
32 "residential": null,
33 "federal_tax_id": null,
34 "state_tax_id": null,
35 "verifications": {}
36 },
37 "to_address": {
38 "id": "adr_e51381df2d1611f0b9803cecef1b359e",
39 "object": "Address",
40 "created_at": "2025-05-09T20:48:00+00:00",
41 "updated_at": "2025-05-09T20:48:01+00:00",
42 "name": "DR. STEVE BRULE",
43 "company": null,
44 "street1": "179 N HARBOR DR",
45 "street2": "",
46 "city": "REDONDO BEACH",
47 "state": "CA",
48 "zip": "90277-2506",
49 "country": "US",
50 "phone": "8573875756",
51 "email": "DR_STEVE_BRULE@GMAIL.COM",
52 "mode": "test",
53 "carrier_facility": null,
54 "residential": false,
55 "federal_tax_id": null,
56 "state_tax_id": null,
57 "verifications": {
58 "zip4": {
59 "success": true,
60 "errors": [],
61 "details": null
62 },
63 "delivery": {
64 "success": true,
65 "errors": [],
66 "details": {
67 "latitude": 33.8436,
68 "longitude": -118.39177,
69 "time_zone": "America/Los_Angeles"
70 }
71 }
72 }
73 },
74 "buyer_address": {
75 "id": "adr_e51381df2d1611f0b9803cecef1b359e",
76 "object": "Address",
77 "created_at": "2025-05-09T20:48:00+00:00",
78 "updated_at": "2025-05-09T20:48:01+00:00",
79 "name": "DR. STEVE BRULE",
80 "company": null,
81 "street1": "179 N HARBOR DR",
82 "street2": "",
83 "city": "REDONDO BEACH",
84 "state": "CA",
85 "zip": "90277-2506",
86 "country": "US",
87 "phone": "8573875756",
88 "email": "DR_STEVE_BRULE@GMAIL.COM",
89 "mode": "test",
90 "carrier_facility": null,
91 "residential": false,
92 "federal_tax_id": null,
93 "state_tax_id": null,
94 "verifications": {
95 "zip4": {
96 "success": true,
97 "errors": [],
98 "details": null
99 },
100 "delivery": {
101 "success": true,
102 "errors": [],
103 "details": {
104 "latitude": 33.8436,
105 "longitude": -118.39177,
106 "time_zone": "America/Los_Angeles"
107 }
108 }
109 }
110 },
111 "return_address": {
112 "id": "adr_e51506082d1611f0b9823cecef1b359e",
113 "object": "Address",
114 "created_at": "2025-05-09T20:48:00+00:00",
115 "updated_at": "2025-05-09T20:48:00+00:00",
116 "name": "EasyPost",
117 "company": null,
118 "street1": "417 Montgomery Street",
119 "street2": "5th Floor",
120 "city": "San Francisco",
121 "state": "CA",
122 "zip": "94104",
123 "country": "US",
124 "phone": "4153334445",
125 "email": "support@easypost.com",
126 "mode": "test",
127 "carrier_facility": null,
128 "residential": null,
129 "federal_tax_id": null,
130 "state_tax_id": null,
131 "verifications": {}
132 },
133 "shipments": [
134 {
135 "id": "shp_dc956f485e2540889b7f7eab7d668b88",
136 "created_at": "2025-05-09T20:48:00Z",
137 "is_return": false,
138 "messages": [],
139 "mode": "test",
140 "options": {
141 "currency": "USD",
142 "payment": {
143 "type": "SENDER"
144 },
145 "date_advance": 0
146 },
147 "reference": null,
148 "status": "unknown",
149 "tracking_code": "9400100208303109837512",
150 "updated_at": "2025-05-09T20:48:01Z",
151 "batch_id": null,
152 "batch_status": null,
153 "batch_message": null,
154 "customs_info": null,
155 "from_address": {
156 "id": "adr_e51506082d1611f0b9823cecef1b359e",
157 "object": "Address",
158 "created_at": "2025-05-09T20:48:00+00:00",
159 "updated_at": "2025-05-09T20:48:00+00:00",
160 "name": "EasyPost",
161 "company": null,
162 "street1": "417 Montgomery Street",
163 "street2": "5th Floor",
164 "city": "San Francisco",
165 "state": "CA",
166 "zip": "94104",
167 "country": "US",
168 "phone": "4153334445",
169 "email": "support@easypost.com",
170 "mode": "test",
171 "carrier_facility": null,
172 "residential": null,
173 "federal_tax_id": null,
174 "state_tax_id": null,
175 "verifications": {}
176 },
177 "insurance": null,
178 "order_id": "order_dae84134c5d54a01a57ff6eab32c34a2",
179 "parcel": {
180 "id": "prcl_dbd3f85ebce547f3baf9285545bc86cf",
181 "object": "Parcel",
182 "created_at": "2025-05-09T20:48:00Z",
183 "updated_at": "2025-05-09T20:48:00Z",
184 "length": null,
185 "width": null,
186 "height": null,
187 "predefined_package": null,
188 "weight": 10.2,
189 "mode": "test"
190 },
191 "postage_label": {
192 "object": "PostageLabel",
193 "id": "pl_ec778bac45c848ffb010782a8ac9d794",
194 "created_at": "2025-05-09T20:48:01Z",
195 "updated_at": "2025-05-09T20:48:01Z",
196 "date_advance": 0,
197 "integrated_form": "none",
198 "label_date": "2025-05-09T20:48:01Z",
199 "label_resolution": 300,
200 "label_size": "4x6",
201 "label_type": "default",
202 "label_file_type": "image/png",
203 "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250509/e811f9e30a55d8495691c382633bd1de27.png",
204 "label_pdf_url": null,
205 "label_zpl_url": null,
206 "label_epl2_url": null,
207 "label_file": null
208 },
209 "rates": [
210 {
211 "id": "rate_76b94a6a12e4451ebd2c83d643499e52",
212 "object": "Rate",
213 "created_at": "2025-05-09T20:48:00Z",
214 "updated_at": "2025-05-09T20:48:00Z",
215 "mode": "test",
216 "service": "Express",
217 "carrier": "USPS",
218 "rate": "34.15",
219 "currency": "USD",
220 "retail_rate": "39.10",
221 "retail_currency": "USD",
222 "list_rate": "34.15",
223 "list_currency": "USD",
224 "billing_type": "easypost",
225 "delivery_days": 2,
226 "delivery_date": null,
227 "delivery_date_guaranteed": false,
228 "est_delivery_days": 2,
229 "shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
230 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
231 },
232 {
233 "id": "rate_f5162cf3d5404cde8b9152111f35f691",
234 "object": "Rate",
235 "created_at": "2025-05-09T20:48:00Z",
236 "updated_at": "2025-05-09T20:48:00Z",
237 "mode": "test",
238 "service": "Priority",
239 "carrier": "USPS",
240 "rate": "7.42",
241 "currency": "USD",
242 "retail_rate": "9.90",
243 "retail_currency": "USD",
244 "list_rate": "8.34",
245 "list_currency": "USD",
246 "billing_type": "easypost",
247 "delivery_days": 2,
248 "delivery_date": null,
249 "delivery_date_guaranteed": false,
250 "est_delivery_days": 2,
251 "shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
252 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
253 },
254 {
255 "id": "rate_d7494d4d8044411ab025bf44a7bb5400",
256 "object": "Rate",
257 "created_at": "2025-05-09T20:48:00Z",
258 "updated_at": "2025-05-09T20:48:00Z",
259 "mode": "test",
260 "service": "GroundAdvantage",
261 "carrier": "USPS",
262 "rate": "5.21",
263 "currency": "USD",
264 "retail_rate": "7.00",
265 "retail_currency": "USD",
266 "list_rate": "5.21",
267 "list_currency": "USD",
268 "billing_type": "easypost",
269 "delivery_days": 3,
270 "delivery_date": null,
271 "delivery_date_guaranteed": false,
272 "est_delivery_days": 3,
273 "shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
274 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
275 }
276 ],
277 "refund_status": null,
278 "scan_form": null,
279 "selected_rate": {
280 "id": "rate_d7494d4d8044411ab025bf44a7bb5400",
281 "object": "Rate",
282 "created_at": "2025-05-09T20:48:01Z",
283 "updated_at": "2025-05-09T20:48:01Z",
284 "mode": "test",
285 "service": "GroundAdvantage",
286 "carrier": "USPS",
287 "rate": "5.21",
288 "currency": "USD",
289 "retail_rate": "7.00",
290 "retail_currency": "USD",
291 "list_rate": "5.21",
292 "list_currency": "USD",
293 "billing_type": "easypost",
294 "delivery_days": 3,
295 "delivery_date": null,
296 "delivery_date_guaranteed": false,
297 "est_delivery_days": 3,
298 "shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
299 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
300 },
301 "tracker": {
302 "id": "trk_82b8af6bc0ed482f957360e0a592caaa",
303 "object": "Tracker",
304 "mode": "test",
305 "tracking_code": "9400100208303109837512",
306 "status": "unknown",
307 "status_detail": "unknown",
308 "created_at": "2025-05-09T20:48:02Z",
309 "updated_at": "2025-05-09T20:48:02Z",
310 "signed_by": null,
311 "weight": null,
312 "est_delivery_date": null,
313 "shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
314 "carrier": "USPS",
315 "tracking_details": [],
316 "fees": [],
317 "carrier_detail": null,
318 "public_url": "https://track.easypost.com/djE6dHJrXzgyYjhhZjZiYzBlZDQ4MmY5NTczNjBlMGE1OTJjYWFh"
319 },
320 "to_address": {
321 "id": "adr_e51381df2d1611f0b9803cecef1b359e",
322 "object": "Address",
323 "created_at": "2025-05-09T20:48:00+00:00",
324 "updated_at": "2025-05-09T20:48:01+00:00",
325 "name": "DR. STEVE BRULE",
326 "company": null,
327 "street1": "179 N HARBOR DR",
328 "street2": "",
329 "city": "REDONDO BEACH",
330 "state": "CA",
331 "zip": "90277-2506",
332 "country": "US",
333 "phone": "8573875756",
334 "email": "DR_STEVE_BRULE@GMAIL.COM",
335 "mode": "test",
336 "carrier_facility": null,
337 "residential": false,
338 "federal_tax_id": null,
339 "state_tax_id": null,
340 "verifications": {
341 "zip4": {
342 "success": true,
343 "errors": [],
344 "details": null
345 },
346 "delivery": {
347 "success": true,
348 "errors": [],
349 "details": {
350 "latitude": 33.8436,
351 "longitude": -118.39177,
352 "time_zone": "America/Los_Angeles"
353 }
354 }
355 }
356 },
357 "usps_zone": 4,
358 "return_address": {
359 "id": "adr_e51506082d1611f0b9823cecef1b359e",
360 "object": "Address",
361 "created_at": "2025-05-09T20:48:00+00:00",
362 "updated_at": "2025-05-09T20:48:00+00:00",
363 "name": "EasyPost",
364 "company": null,
365 "street1": "417 Montgomery Street",
366 "street2": "5th Floor",
367 "city": "San Francisco",
368 "state": "CA",
369 "zip": "94104",
370 "country": "US",
371 "phone": "4153334445",
372 "email": "support@easypost.com",
373 "mode": "test",
374 "carrier_facility": null,
375 "residential": null,
376 "federal_tax_id": null,
377 "state_tax_id": null,
378 "verifications": {}
379 },
380 "buyer_address": {
381 "id": "adr_e51381df2d1611f0b9803cecef1b359e",
382 "object": "Address",
383 "created_at": "2025-05-09T20:48:00+00:00",
384 "updated_at": "2025-05-09T20:48:01+00:00",
385 "name": "DR. STEVE BRULE",
386 "company": null,
387 "street1": "179 N HARBOR DR",
388 "street2": "",
389 "city": "REDONDO BEACH",
390 "state": "CA",
391 "zip": "90277-2506",
392 "country": "US",
393 "phone": "8573875756",
394 "email": "DR_STEVE_BRULE@GMAIL.COM",
395 "mode": "test",
396 "carrier_facility": null,
397 "residential": false,
398 "federal_tax_id": null,
399 "state_tax_id": null,
400 "verifications": {
401 "zip4": {
402 "success": true,
403 "errors": [],
404 "details": null
405 },
406 "delivery": {
407 "success": true,
408 "errors": [],
409 "details": {
410 "latitude": 33.8436,
411 "longitude": -118.39177,
412 "time_zone": "America/Los_Angeles"
413 }
414 }
415 }
416 },
417 "forms": [],
418 "fees": [
419 {
420 "object": "Fee",
421 "type": "PostageFee",
422 "amount": "5.21000",
423 "charged": true,
424 "refunded": false
425 }
426 ],
427 "object": "Shipment"
428 },
429 {
430 "id": "shp_fe48581e16154012b1e51ad5606d34c1",
431 "created_at": "2025-05-09T20:48:00Z",
432 "is_return": false,
433 "messages": [],
434 "mode": "test",
435 "options": {
436 "currency": "USD",
437 "payment": {
438 "type": "SENDER"
439 },
440 "date_advance": 0
441 },
442 "reference": null,
443 "status": "unknown",
444 "tracking_code": "9434600208303109842303",
445 "updated_at": "2025-05-09T20:48:02Z",
446 "batch_id": null,
447 "batch_status": null,
448 "batch_message": null,
449 "customs_info": null,
450 "from_address": {
451 "id": "adr_e51506082d1611f0b9823cecef1b359e",
452 "object": "Address",
453 "created_at": "2025-05-09T20:48:00+00:00",
454 "updated_at": "2025-05-09T20:48:00+00:00",
455 "name": "EasyPost",
456 "company": null,
457 "street1": "417 Montgomery Street",
458 "street2": "5th Floor",
459 "city": "San Francisco",
460 "state": "CA",
461 "zip": "94104",
462 "country": "US",
463 "phone": "4153334445",
464 "email": "support@easypost.com",
465 "mode": "test",
466 "carrier_facility": null,
467 "residential": null,
468 "federal_tax_id": null,
469 "state_tax_id": null,
470 "verifications": {}
471 },
472 "insurance": null,
473 "order_id": "order_dae84134c5d54a01a57ff6eab32c34a2",
474 "parcel": {
475 "id": "prcl_69844696fd314ceeb78bb9969034a102",
476 "object": "Parcel",
477 "created_at": "2025-05-09T20:48:00Z",
478 "updated_at": "2025-05-09T20:48:00Z",
479 "length": null,
480 "width": null,
481 "height": null,
482 "predefined_package": null,
483 "weight": 17.5,
484 "mode": "test"
485 },
486 "postage_label": {
487 "object": "PostageLabel",
488 "id": "pl_417029731e9d45c8b7e2750043a3517d",
489 "created_at": "2025-05-09T20:48:01Z",
490 "updated_at": "2025-05-09T20:48:02Z",
491 "date_advance": 0,
492 "integrated_form": "none",
493 "label_date": "2025-05-09T20:48:01Z",
494 "label_resolution": 300,
495 "label_size": "4x6",
496 "label_type": "default",
497 "label_file_type": "image/png",
498 "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250509/e864b415157bbf4709a37a07e9a5cd1550.png",
499 "label_pdf_url": null,
500 "label_zpl_url": null,
501 "label_epl2_url": null,
502 "label_file": null
503 },
504 "rates": [
505 {
506 "id": "rate_cc10630499d943208164f119319612a2",
507 "object": "Rate",
508 "created_at": "2025-05-09T20:48:00Z",
509 "updated_at": "2025-05-09T20:48:00Z",
510 "mode": "test",
511 "service": "Priority",
512 "carrier": "USPS",
513 "rate": "8.22",
514 "currency": "USD",
515 "retail_rate": "12.65",
516 "retail_currency": "USD",
517 "list_rate": "9.07",
518 "list_currency": "USD",
519 "billing_type": "easypost",
520 "delivery_days": 2,
521 "delivery_date": null,
522 "delivery_date_guaranteed": false,
523 "est_delivery_days": 2,
524 "shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
525 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
526 },
527 {
528 "id": "rate_270b4cbb74434de5883abdd54d308788",
529 "object": "Rate",
530 "created_at": "2025-05-09T20:48:00Z",
531 "updated_at": "2025-05-09T20:48:00Z",
532 "mode": "test",
533 "service": "GroundAdvantage",
534 "carrier": "USPS",
535 "rate": "6.53",
536 "currency": "USD",
537 "retail_rate": "11.40",
538 "retail_currency": "USD",
539 "list_rate": "8.05",
540 "list_currency": "USD",
541 "billing_type": "easypost",
542 "delivery_days": 3,
543 "delivery_date": null,
544 "delivery_date_guaranteed": false,
545 "est_delivery_days": 3,
546 "shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
547 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
548 },
549 {
550 "id": "rate_5ec54c14e6a147ada7d670f294a40a1b",
551 "object": "Rate",
552 "created_at": "2025-05-09T20:48:00Z",
553 "updated_at": "2025-05-09T20:48:00Z",
554 "mode": "test",
555 "service": "Express",
556 "carrier": "USPS",
557 "rate": "38.40",
558 "currency": "USD",
559 "retail_rate": "44.15",
560 "retail_currency": "USD",
561 "list_rate": "38.40",
562 "list_currency": "USD",
563 "billing_type": "easypost",
564 "delivery_days": 2,
565 "delivery_date": null,
566 "delivery_date_guaranteed": false,
567 "est_delivery_days": 2,
568 "shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
569 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
570 }
571 ],
572 "refund_status": null,
573 "scan_form": null,
574 "selected_rate": {
575 "id": "rate_270b4cbb74434de5883abdd54d308788",
576 "object": "Rate",
577 "created_at": "2025-05-09T20:48:01Z",
578 "updated_at": "2025-05-09T20:48:01Z",
579 "mode": "test",
580 "service": "GroundAdvantage",
581 "carrier": "USPS",
582 "rate": "6.53",
583 "currency": "USD",
584 "retail_rate": "11.40",
585 "retail_currency": "USD",
586 "list_rate": "8.05",
587 "list_currency": "USD",
588 "billing_type": "easypost",
589 "delivery_days": 3,
590 "delivery_date": null,
591 "delivery_date_guaranteed": false,
592 "est_delivery_days": 3,
593 "shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
594 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
595 },
596 "tracker": {
597 "id": "trk_545fffdf10084dab8a56046d00b08ad7",
598 "object": "Tracker",
599 "mode": "test",
600 "tracking_code": "9434600208303109842303",
601 "status": "unknown",
602 "status_detail": "unknown",
603 "created_at": "2025-05-09T20:48:02Z",
604 "updated_at": "2025-05-09T20:48:02Z",
605 "signed_by": null,
606 "weight": null,
607 "est_delivery_date": null,
608 "shipment_id": "shp_fe48581e16154012b1e51ad5606d34c1",
609 "carrier": "USPS",
610 "tracking_details": [],
611 "fees": [],
612 "carrier_detail": null,
613 "public_url": "https://track.easypost.com/djE6dHJrXzU0NWZmZmRmMTAwODRkYWI4YTU2MDQ2ZDAwYjA4YWQ3"
614 },
615 "to_address": {
616 "id": "adr_e51381df2d1611f0b9803cecef1b359e",
617 "object": "Address",
618 "created_at": "2025-05-09T20:48:00+00:00",
619 "updated_at": "2025-05-09T20:48:01+00:00",
620 "name": "DR. STEVE BRULE",
621 "company": null,
622 "street1": "179 N HARBOR DR",
623 "street2": "",
624 "city": "REDONDO BEACH",
625 "state": "CA",
626 "zip": "90277-2506",
627 "country": "US",
628 "phone": "8573875756",
629 "email": "DR_STEVE_BRULE@GMAIL.COM",
630 "mode": "test",
631 "carrier_facility": null,
632 "residential": false,
633 "federal_tax_id": null,
634 "state_tax_id": null,
635 "verifications": {
636 "zip4": {
637 "success": true,
638 "errors": [],
639 "details": null
640 },
641 "delivery": {
642 "success": true,
643 "errors": [],
644 "details": {
645 "latitude": 33.8436,
646 "longitude": -118.39177,
647 "time_zone": "America/Los_Angeles"
648 }
649 }
650 }
651 },
652 "usps_zone": 4,
653 "return_address": {
654 "id": "adr_e51506082d1611f0b9823cecef1b359e",
655 "object": "Address",
656 "created_at": "2025-05-09T20:48:00+00:00",
657 "updated_at": "2025-05-09T20:48:00+00:00",
658 "name": "EasyPost",
659 "company": null,
660 "street1": "417 Montgomery Street",
661 "street2": "5th Floor",
662 "city": "San Francisco",
663 "state": "CA",
664 "zip": "94104",
665 "country": "US",
666 "phone": "4153334445",
667 "email": "support@easypost.com",
668 "mode": "test",
669 "carrier_facility": null,
670 "residential": null,
671 "federal_tax_id": null,
672 "state_tax_id": null,
673 "verifications": {}
674 },
675 "buyer_address": {
676 "id": "adr_e51381df2d1611f0b9803cecef1b359e",
677 "object": "Address",
678 "created_at": "2025-05-09T20:48:00+00:00",
679 "updated_at": "2025-05-09T20:48:01+00:00",
680 "name": "DR. STEVE BRULE",
681 "company": null,
682 "street1": "179 N HARBOR DR",
683 "street2": "",
684 "city": "REDONDO BEACH",
685 "state": "CA",
686 "zip": "90277-2506",
687 "country": "US",
688 "phone": "8573875756",
689 "email": "DR_STEVE_BRULE@GMAIL.COM",
690 "mode": "test",
691 "carrier_facility": null,
692 "residential": false,
693 "federal_tax_id": null,
694 "state_tax_id": null,
695 "verifications": {
696 "zip4": {
697 "success": true,
698 "errors": [],
699 "details": null
700 },
701 "delivery": {
702 "success": true,
703 "errors": [],
704 "details": {
705 "latitude": 33.8436,
706 "longitude": -118.39177,
707 "time_zone": "America/Los_Angeles"
708 }
709 }
710 }
711 },
712 "forms": [],
713 "fees": [
714 {
715 "object": "Fee",
716 "type": "PostageFee",
717 "amount": "6.53000",
718 "charged": true,
719 "refunded": false
720 }
721 ],
722 "object": "Shipment"
723 }
724 ],
725 "rates": [
726 {
727 "id": "rate_76b94a6a12e4451ebd2c83d643499e52",
728 "object": "Rate",
729 "created_at": null,
730 "updated_at": null,
731 "mode": "test",
732 "service": "Express",
733 "carrier": "USPS",
734 "rate": "72.55",
735 "currency": "USD",
736 "retail_rate": "83.25",
737 "retail_currency": "USD",
738 "list_rate": "72.55",
739 "list_currency": "USD",
740 "billing_type": "easypost",
741 "delivery_days": 2,
742 "delivery_date": null,
743 "delivery_date_guaranteed": false,
744 "est_delivery_days": 2,
745 "shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
746 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
747 },
748 {
749 "id": "rate_f5162cf3d5404cde8b9152111f35f691",
750 "object": "Rate",
751 "created_at": null,
752 "updated_at": null,
753 "mode": "test",
754 "service": "Priority",
755 "carrier": "USPS",
756 "rate": "15.64",
757 "currency": "USD",
758 "retail_rate": "22.55",
759 "retail_currency": "USD",
760 "list_rate": "17.41",
761 "list_currency": "USD",
762 "billing_type": "easypost",
763 "delivery_days": 2,
764 "delivery_date": null,
765 "delivery_date_guaranteed": false,
766 "est_delivery_days": 2,
767 "shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
768 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
769 },
770 {
771 "id": "rate_d7494d4d8044411ab025bf44a7bb5400",
772 "object": "Rate",
773 "created_at": null,
774 "updated_at": null,
775 "mode": "test",
776 "service": "GroundAdvantage",
777 "carrier": "USPS",
778 "rate": "11.74",
779 "currency": "USD",
780 "retail_rate": "18.40",
781 "retail_currency": "USD",
782 "list_rate": "13.26",
783 "list_currency": "USD",
784 "billing_type": "easypost",
785 "delivery_days": 3,
786 "delivery_date": null,
787 "delivery_date_guaranteed": false,
788 "est_delivery_days": 3,
789 "shipment_id": "shp_dc956f485e2540889b7f7eab7d668b88",
790 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
791 }
792 ],
793 "id": "order_dae84134c5d54a01a57ff6eab32c34a2",
794 "object": "Order"
795}
There is an alternative way to purchase orders that is known as the "one-call buy" method. This method is often used if you have a flat-rate set with a mail carrier for a given service level, or if you know your desired service level without needing to see the rate first.
Utilizing the "one-call buy" method can improve the performance of your integration, because it cuts out an API call from our standard "create order" then "buy order" workflow.
In order to achieve this behavior, all you have to do is add a carrier_account
and service
name to your creation API call.
Request Parameters
Shipment
array1curl -X POST https://api.easypost.com/v2/orders \
2 -u "EASYPOST_API_KEY": \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "order": {
6 "to_address": {
7 "id": "adr_..."
8 },
9 "from_address": {
10 "id": "adr_..."
11 },
12 "shipments": [
13 {
14 "parcel": {
15 "weight": "10.2"
16 }
17 },
18 {
19 "parcel": {
20 "predefined_package": "FedExBox",
21 "weight": "17.5"
22 }
23 }
24 ],
25 "service": "NextDayAir",
26 "carrier_accounts": ["ca_..."]
27 }
28 }'
1{
2 "created_at": "2025-05-09T20:48:02Z",
3 "messages": [],
4 "mode": "test",
5 "reference": "",
6 "is_return": false,
7 "options": {
8 "currency": "USD",
9 "payment": {
10 "type": "SENDER"
11 }
12 },
13 "updated_at": "2025-05-09T20:48:02Z",
14 "customs_info": null,
15 "from_address": {
16 "id": "adr_e642a6052d1611f0985fac1f6bc539aa",
17 "object": "Address",
18 "created_at": "2025-05-09T20:48:02+00:00",
19 "updated_at": "2025-05-09T20:48:02+00:00",
20 "name": "EasyPost",
21 "company": null,
22 "street1": "417 Montgomery Street",
23 "street2": "5th Floor",
24 "city": "San Francisco",
25 "state": "CA",
26 "zip": "94104",
27 "country": "US",
28 "phone": "4153334445",
29 "email": "support@easypost.com",
30 "mode": "test",
31 "carrier_facility": null,
32 "residential": null,
33 "federal_tax_id": null,
34 "state_tax_id": null,
35 "verifications": {}
36 },
37 "to_address": {
38 "id": "adr_e6409ef02d1611f0ba643cecef1b359e",
39 "object": "Address",
40 "created_at": "2025-05-09T20:48:02+00:00",
41 "updated_at": "2025-05-09T20:48:03+00:00",
42 "name": "DR. STEVE BRULE",
43 "company": null,
44 "street1": "179 N HARBOR DR",
45 "street2": "",
46 "city": "REDONDO BEACH",
47 "state": "CA",
48 "zip": "90277-2506",
49 "country": "US",
50 "phone": "8573875756",
51 "email": "DR_STEVE_BRULE@GMAIL.COM",
52 "mode": "test",
53 "carrier_facility": null,
54 "residential": false,
55 "federal_tax_id": null,
56 "state_tax_id": null,
57 "verifications": {
58 "zip4": {
59 "success": true,
60 "errors": [],
61 "details": null
62 },
63 "delivery": {
64 "success": true,
65 "errors": [],
66 "details": {
67 "latitude": 33.8436,
68 "longitude": -118.39177,
69 "time_zone": "America/Los_Angeles"
70 }
71 }
72 }
73 },
74 "buyer_address": {
75 "id": "adr_e6409ef02d1611f0ba643cecef1b359e",
76 "object": "Address",
77 "created_at": "2025-05-09T20:48:02+00:00",
78 "updated_at": "2025-05-09T20:48:03+00:00",
79 "name": "DR. STEVE BRULE",
80 "company": null,
81 "street1": "179 N HARBOR DR",
82 "street2": "",
83 "city": "REDONDO BEACH",
84 "state": "CA",
85 "zip": "90277-2506",
86 "country": "US",
87 "phone": "8573875756",
88 "email": "DR_STEVE_BRULE@GMAIL.COM",
89 "mode": "test",
90 "carrier_facility": null,
91 "residential": false,
92 "federal_tax_id": null,
93 "state_tax_id": null,
94 "verifications": {
95 "zip4": {
96 "success": true,
97 "errors": [],
98 "details": null
99 },
100 "delivery": {
101 "success": true,
102 "errors": [],
103 "details": {
104 "latitude": 33.8436,
105 "longitude": -118.39177,
106 "time_zone": "America/Los_Angeles"
107 }
108 }
109 }
110 },
111 "return_address": {
112 "id": "adr_e642a6052d1611f0985fac1f6bc539aa",
113 "object": "Address",
114 "created_at": "2025-05-09T20:48:02+00:00",
115 "updated_at": "2025-05-09T20:48:02+00:00",
116 "name": "EasyPost",
117 "company": null,
118 "street1": "417 Montgomery Street",
119 "street2": "5th Floor",
120 "city": "San Francisco",
121 "state": "CA",
122 "zip": "94104",
123 "country": "US",
124 "phone": "4153334445",
125 "email": "support@easypost.com",
126 "mode": "test",
127 "carrier_facility": null,
128 "residential": null,
129 "federal_tax_id": null,
130 "state_tax_id": null,
131 "verifications": {}
132 },
133 "shipments": [
134 {
135 "id": "shp_65e970abcfe642dabde0bea8600078c9",
136 "created_at": "2025-05-09T20:48:02Z",
137 "is_return": false,
138 "messages": [],
139 "mode": "test",
140 "options": {
141 "currency": "USD",
142 "payment": {
143 "type": "SENDER"
144 },
145 "date_advance": 0
146 },
147 "reference": null,
148 "status": "unknown",
149 "tracking_code": "9400100208303109837529",
150 "updated_at": "2025-05-09T20:48:03Z",
151 "batch_id": null,
152 "batch_status": null,
153 "batch_message": null,
154 "customs_info": null,
155 "from_address": {
156 "id": "adr_e642a6052d1611f0985fac1f6bc539aa",
157 "object": "Address",
158 "created_at": "2025-05-09T20:48:02+00:00",
159 "updated_at": "2025-05-09T20:48:02+00:00",
160 "name": "EasyPost",
161 "company": null,
162 "street1": "417 Montgomery Street",
163 "street2": "5th Floor",
164 "city": "San Francisco",
165 "state": "CA",
166 "zip": "94104",
167 "country": "US",
168 "phone": "4153334445",
169 "email": "support@easypost.com",
170 "mode": "test",
171 "carrier_facility": null,
172 "residential": null,
173 "federal_tax_id": null,
174 "state_tax_id": null,
175 "verifications": {}
176 },
177 "insurance": null,
178 "order_id": "order_f7cdd537d4174067a0c095b5b2255213",
179 "parcel": {
180 "id": "prcl_aaabe709a41740528774f497818ab0ad",
181 "object": "Parcel",
182 "created_at": "2025-05-09T20:48:02Z",
183 "updated_at": "2025-05-09T20:48:02Z",
184 "length": null,
185 "width": null,
186 "height": null,
187 "predefined_package": null,
188 "weight": 10.2,
189 "mode": "test"
190 },
191 "postage_label": {
192 "object": "PostageLabel",
193 "id": "pl_2ae7be450f72492982bf12dafdca9fb5",
194 "created_at": "2025-05-09T20:48:03Z",
195 "updated_at": "2025-05-09T20:48:03Z",
196 "date_advance": 0,
197 "integrated_form": "none",
198 "label_date": "2025-05-09T20:48:03Z",
199 "label_resolution": 300,
200 "label_size": "4x6",
201 "label_type": "default",
202 "label_file_type": "image/png",
203 "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250509/e8ad30ded015d147b3a054b72ca87ffcbb.png",
204 "label_pdf_url": null,
205 "label_zpl_url": null,
206 "label_epl2_url": null,
207 "label_file": null
208 },
209 "rates": [
210 {
211 "id": "rate_f5c525e085fc4fba9b93b6bc98968f90",
212 "object": "Rate",
213 "created_at": "2025-05-09T20:48:02Z",
214 "updated_at": "2025-05-09T20:48:02Z",
215 "mode": "test",
216 "service": "Express",
217 "carrier": "USPS",
218 "rate": "34.15",
219 "currency": "USD",
220 "retail_rate": "39.10",
221 "retail_currency": "USD",
222 "list_rate": "34.15",
223 "list_currency": "USD",
224 "billing_type": "easypost",
225 "delivery_days": 2,
226 "delivery_date": null,
227 "delivery_date_guaranteed": false,
228 "est_delivery_days": 2,
229 "shipment_id": "shp_65e970abcfe642dabde0bea8600078c9",
230 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
231 },
232 {
233 "id": "rate_6300df44a8a3481f8b5b2655bbb1e9d1",
234 "object": "Rate",
235 "created_at": "2025-05-09T20:48:02Z",
236 "updated_at": "2025-05-09T20:48:02Z",
237 "mode": "test",
238 "service": "Priority",
239 "carrier": "USPS",
240 "rate": "7.42",
241 "currency": "USD",
242 "retail_rate": "9.90",
243 "retail_currency": "USD",
244 "list_rate": "8.34",
245 "list_currency": "USD",
246 "billing_type": "easypost",
247 "delivery_days": 2,
248 "delivery_date": null,
249 "delivery_date_guaranteed": false,
250 "est_delivery_days": 2,
251 "shipment_id": "shp_65e970abcfe642dabde0bea8600078c9",
252 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
253 },
254 {
255 "id": "rate_fae3ae6baf3043718d64763747316e57",
256 "object": "Rate",
257 "created_at": "2025-05-09T20:48:02Z",
258 "updated_at": "2025-05-09T20:48:02Z",
259 "mode": "test",
260 "service": "GroundAdvantage",
261 "carrier": "USPS",
262 "rate": "5.21",
263 "currency": "USD",
264 "retail_rate": "7.00",
265 "retail_currency": "USD",
266 "list_rate": "5.21",
267 "list_currency": "USD",
268 "billing_type": "easypost",
269 "delivery_days": 3,
270 "delivery_date": null,
271 "delivery_date_guaranteed": false,
272 "est_delivery_days": 3,
273 "shipment_id": "shp_65e970abcfe642dabde0bea8600078c9",
274 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
275 }
276 ],
277 "refund_status": null,
278 "scan_form": null,
279 "selected_rate": {
280 "id": "rate_fae3ae6baf3043718d64763747316e57",
281 "object": "Rate",
282 "created_at": "2025-05-09T20:48:03Z",
283 "updated_at": "2025-05-09T20:48:03Z",
284 "mode": "test",
285 "service": "GroundAdvantage",
286 "carrier": "USPS",
287 "rate": "5.21",
288 "currency": "USD",
289 "retail_rate": "7.00",
290 "retail_currency": "USD",
291 "list_rate": "5.21",
292 "list_currency": "USD",
293 "billing_type": "easypost",
294 "delivery_days": 3,
295 "delivery_date": null,
296 "delivery_date_guaranteed": false,
297 "est_delivery_days": 3,
298 "shipment_id": "shp_65e970abcfe642dabde0bea8600078c9",
299 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
300 },
301 "tracker": {
302 "id": "trk_b4c289faa928424a881bf0c2351287ef",
303 "object": "Tracker",
304 "mode": "test",
305 "tracking_code": "9400100208303109837529",
306 "status": "unknown",
307 "status_detail": "unknown",
308 "created_at": "2025-05-09T20:48:03Z",
309 "updated_at": "2025-05-09T20:48:03Z",
310 "signed_by": null,
311 "weight": null,
312 "est_delivery_date": null,
313 "shipment_id": "shp_65e970abcfe642dabde0bea8600078c9",
314 "carrier": "USPS",
315 "tracking_details": [],
316 "fees": [],
317 "carrier_detail": null,
318 "public_url": "https://track.easypost.com/djE6dHJrX2I0YzI4OWZhYTkyODQyNGE4ODFiZjBjMjM1MTI4N2Vm"
319 },
320 "to_address": {
321 "id": "adr_e6409ef02d1611f0ba643cecef1b359e",
322 "object": "Address",
323 "created_at": "2025-05-09T20:48:02+00:00",
324 "updated_at": "2025-05-09T20:48:03+00:00",
325 "name": "DR. STEVE BRULE",
326 "company": null,
327 "street1": "179 N HARBOR DR",
328 "street2": "",
329 "city": "REDONDO BEACH",
330 "state": "CA",
331 "zip": "90277-2506",
332 "country": "US",
333 "phone": "8573875756",
334 "email": "DR_STEVE_BRULE@GMAIL.COM",
335 "mode": "test",
336 "carrier_facility": null,
337 "residential": false,
338 "federal_tax_id": null,
339 "state_tax_id": null,
340 "verifications": {
341 "zip4": {
342 "success": true,
343 "errors": [],
344 "details": null
345 },
346 "delivery": {
347 "success": true,
348 "errors": [],
349 "details": {
350 "latitude": 33.8436,
351 "longitude": -118.39177,
352 "time_zone": "America/Los_Angeles"
353 }
354 }
355 }
356 },
357 "usps_zone": 4,
358 "return_address": {
359 "id": "adr_e642a6052d1611f0985fac1f6bc539aa",
360 "object": "Address",
361 "created_at": "2025-05-09T20:48:02+00:00",
362 "updated_at": "2025-05-09T20:48:02+00:00",
363 "name": "EasyPost",
364 "company": null,
365 "street1": "417 Montgomery Street",
366 "street2": "5th Floor",
367 "city": "San Francisco",
368 "state": "CA",
369 "zip": "94104",
370 "country": "US",
371 "phone": "4153334445",
372 "email": "support@easypost.com",
373 "mode": "test",
374 "carrier_facility": null,
375 "residential": null,
376 "federal_tax_id": null,
377 "state_tax_id": null,
378 "verifications": {}
379 },
380 "buyer_address": {
381 "id": "adr_e6409ef02d1611f0ba643cecef1b359e",
382 "object": "Address",
383 "created_at": "2025-05-09T20:48:02+00:00",
384 "updated_at": "2025-05-09T20:48:03+00:00",
385 "name": "DR. STEVE BRULE",
386 "company": null,
387 "street1": "179 N HARBOR DR",
388 "street2": "",
389 "city": "REDONDO BEACH",
390 "state": "CA",
391 "zip": "90277-2506",
392 "country": "US",
393 "phone": "8573875756",
394 "email": "DR_STEVE_BRULE@GMAIL.COM",
395 "mode": "test",
396 "carrier_facility": null,
397 "residential": false,
398 "federal_tax_id": null,
399 "state_tax_id": null,
400 "verifications": {
401 "zip4": {
402 "success": true,
403 "errors": [],
404 "details": null
405 },
406 "delivery": {
407 "success": true,
408 "errors": [],
409 "details": {
410 "latitude": 33.8436,
411 "longitude": -118.39177,
412 "time_zone": "America/Los_Angeles"
413 }
414 }
415 }
416 },
417 "forms": [],
418 "fees": [
419 {
420 "object": "Fee",
421 "type": "PostageFee",
422 "amount": "5.21000",
423 "charged": true,
424 "refunded": false
425 }
426 ],
427 "object": "Shipment"
428 },
429 {
430 "id": "shp_b220f252f85a4b4eb6e729c8ab7f670f",
431 "created_at": "2025-05-09T20:48:02Z",
432 "is_return": false,
433 "messages": [],
434 "mode": "test",
435 "options": {
436 "currency": "USD",
437 "payment": {
438 "type": "SENDER"
439 },
440 "date_advance": 0
441 },
442 "reference": null,
443 "status": "unknown",
444 "tracking_code": "9434600208303109842310",
445 "updated_at": "2025-05-09T20:48:03Z",
446 "batch_id": null,
447 "batch_status": null,
448 "batch_message": null,
449 "customs_info": null,
450 "from_address": {
451 "id": "adr_e642a6052d1611f0985fac1f6bc539aa",
452 "object": "Address",
453 "created_at": "2025-05-09T20:48:02+00:00",
454 "updated_at": "2025-05-09T20:48:02+00:00",
455 "name": "EasyPost",
456 "company": null,
457 "street1": "417 Montgomery Street",
458 "street2": "5th Floor",
459 "city": "San Francisco",
460 "state": "CA",
461 "zip": "94104",
462 "country": "US",
463 "phone": "4153334445",
464 "email": "support@easypost.com",
465 "mode": "test",
466 "carrier_facility": null,
467 "residential": null,
468 "federal_tax_id": null,
469 "state_tax_id": null,
470 "verifications": {}
471 },
472 "insurance": null,
473 "order_id": "order_f7cdd537d4174067a0c095b5b2255213",
474 "parcel": {
475 "id": "prcl_6dc78727bc2244619c4d2174f056e623",
476 "object": "Parcel",
477 "created_at": "2025-05-09T20:48:02Z",
478 "updated_at": "2025-05-09T20:48:02Z",
479 "length": null,
480 "width": null,
481 "height": null,
482 "predefined_package": null,
483 "weight": 17.5,
484 "mode": "test"
485 },
486 "postage_label": {
487 "object": "PostageLabel",
488 "id": "pl_028104510b644d76919569a58bb5b2c4",
489 "created_at": "2025-05-09T20:48:03Z",
490 "updated_at": "2025-05-09T20:48:03Z",
491 "date_advance": 0,
492 "integrated_form": "none",
493 "label_date": "2025-05-09T20:48:03Z",
494 "label_resolution": 300,
495 "label_size": "4x6",
496 "label_type": "default",
497 "label_file_type": "image/png",
498 "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250509/e875c8d2dd198440a49f258434622f3c02.png",
499 "label_pdf_url": null,
500 "label_zpl_url": null,
501 "label_epl2_url": null,
502 "label_file": null
503 },
504 "rates": [
505 {
506 "id": "rate_e48c148addc347c1b228e34687ac9e66",
507 "object": "Rate",
508 "created_at": "2025-05-09T20:48:02Z",
509 "updated_at": "2025-05-09T20:48:02Z",
510 "mode": "test",
511 "service": "Express",
512 "carrier": "USPS",
513 "rate": "38.40",
514 "currency": "USD",
515 "retail_rate": "44.15",
516 "retail_currency": "USD",
517 "list_rate": "38.40",
518 "list_currency": "USD",
519 "billing_type": "easypost",
520 "delivery_days": 2,
521 "delivery_date": null,
522 "delivery_date_guaranteed": false,
523 "est_delivery_days": 2,
524 "shipment_id": "shp_b220f252f85a4b4eb6e729c8ab7f670f",
525 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
526 },
527 {
528 "id": "rate_49a02a6a4343464e8a0443f8f0b807d4",
529 "object": "Rate",
530 "created_at": "2025-05-09T20:48:02Z",
531 "updated_at": "2025-05-09T20:48:02Z",
532 "mode": "test",
533 "service": "Priority",
534 "carrier": "USPS",
535 "rate": "8.22",
536 "currency": "USD",
537 "retail_rate": "12.65",
538 "retail_currency": "USD",
539 "list_rate": "9.07",
540 "list_currency": "USD",
541 "billing_type": "easypost",
542 "delivery_days": 2,
543 "delivery_date": null,
544 "delivery_date_guaranteed": false,
545 "est_delivery_days": 2,
546 "shipment_id": "shp_b220f252f85a4b4eb6e729c8ab7f670f",
547 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
548 },
549 {
550 "id": "rate_142de740437e4dd4886f7611b5e48191",
551 "object": "Rate",
552 "created_at": "2025-05-09T20:48:02Z",
553 "updated_at": "2025-05-09T20:48:02Z",
554 "mode": "test",
555 "service": "GroundAdvantage",
556 "carrier": "USPS",
557 "rate": "6.53",
558 "currency": "USD",
559 "retail_rate": "11.40",
560 "retail_currency": "USD",
561 "list_rate": "8.05",
562 "list_currency": "USD",
563 "billing_type": "easypost",
564 "delivery_days": 3,
565 "delivery_date": null,
566 "delivery_date_guaranteed": false,
567 "est_delivery_days": 3,
568 "shipment_id": "shp_b220f252f85a4b4eb6e729c8ab7f670f",
569 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
570 }
571 ],
572 "refund_status": null,
573 "scan_form": null,
574 "selected_rate": {
575 "id": "rate_142de740437e4dd4886f7611b5e48191",
576 "object": "Rate",
577 "created_at": "2025-05-09T20:48:03Z",
578 "updated_at": "2025-05-09T20:48:03Z",
579 "mode": "test",
580 "service": "GroundAdvantage",
581 "carrier": "USPS",
582 "rate": "6.53",
583 "currency": "USD",
584 "retail_rate": "11.40",
585 "retail_currency": "USD",
586 "list_rate": "8.05",
587 "list_currency": "USD",
588 "billing_type": "easypost",
589 "delivery_days": 3,
590 "delivery_date": null,
591 "delivery_date_guaranteed": false,
592 "est_delivery_days": 3,
593 "shipment_id": "shp_b220f252f85a4b4eb6e729c8ab7f670f",
594 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
595 },
596 "tracker": {
597 "id": "trk_5e1dc7abd6d04c3481f4b3c2ccb92a42",
598 "object": "Tracker",
599 "mode": "test",
600 "tracking_code": "9434600208303109842310",
601 "status": "unknown",
602 "status_detail": "unknown",
603 "created_at": "2025-05-09T20:48:03Z",
604 "updated_at": "2025-05-09T20:48:03Z",
605 "signed_by": null,
606 "weight": null,
607 "est_delivery_date": null,
608 "shipment_id": "shp_b220f252f85a4b4eb6e729c8ab7f670f",
609 "carrier": "USPS",
610 "tracking_details": [],
611 "fees": [],
612 "carrier_detail": null,
613 "public_url": "https://track.easypost.com/djE6dHJrXzVlMWRjN2FiZDZkMDRjMzQ4MWY0YjNjMmNjYjkyYTQy"
614 },
615 "to_address": {
616 "id": "adr_e6409ef02d1611f0ba643cecef1b359e",
617 "object": "Address",
618 "created_at": "2025-05-09T20:48:02+00:00",
619 "updated_at": "2025-05-09T20:48:03+00:00",
620 "name": "DR. STEVE BRULE",
621 "company": null,
622 "street1": "179 N HARBOR DR",
623 "street2": "",
624 "city": "REDONDO BEACH",
625 "state": "CA",
626 "zip": "90277-2506",
627 "country": "US",
628 "phone": "8573875756",
629 "email": "DR_STEVE_BRULE@GMAIL.COM",
630 "mode": "test",
631 "carrier_facility": null,
632 "residential": false,
633 "federal_tax_id": null,
634 "state_tax_id": null,
635 "verifications": {
636 "zip4": {
637 "success": true,
638 "errors": [],
639 "details": null
640 },
641 "delivery": {
642 "success": true,
643 "errors": [],
644 "details": {
645 "latitude": 33.8436,
646 "longitude": -118.39177,
647 "time_zone": "America/Los_Angeles"
648 }
649 }
650 }
651 },
652 "usps_zone": 4,
653 "return_address": {
654 "id": "adr_e642a6052d1611f0985fac1f6bc539aa",
655 "object": "Address",
656 "created_at": "2025-05-09T20:48:02+00:00",
657 "updated_at": "2025-05-09T20:48:02+00:00",
658 "name": "EasyPost",
659 "company": null,
660 "street1": "417 Montgomery Street",
661 "street2": "5th Floor",
662 "city": "San Francisco",
663 "state": "CA",
664 "zip": "94104",
665 "country": "US",
666 "phone": "4153334445",
667 "email": "support@easypost.com",
668 "mode": "test",
669 "carrier_facility": null,
670 "residential": null,
671 "federal_tax_id": null,
672 "state_tax_id": null,
673 "verifications": {}
674 },
675 "buyer_address": {
676 "id": "adr_e6409ef02d1611f0ba643cecef1b359e",
677 "object": "Address",
678 "created_at": "2025-05-09T20:48:02+00:00",
679 "updated_at": "2025-05-09T20:48:03+00:00",
680 "name": "DR. STEVE BRULE",
681 "company": null,
682 "street1": "179 N HARBOR DR",
683 "street2": "",
684 "city": "REDONDO BEACH",
685 "state": "CA",
686 "zip": "90277-2506",
687 "country": "US",
688 "phone": "8573875756",
689 "email": "DR_STEVE_BRULE@GMAIL.COM",
690 "mode": "test",
691 "carrier_facility": null,
692 "residential": false,
693 "federal_tax_id": null,
694 "state_tax_id": null,
695 "verifications": {
696 "zip4": {
697 "success": true,
698 "errors": [],
699 "details": null
700 },
701 "delivery": {
702 "success": true,
703 "errors": [],
704 "details": {
705 "latitude": 33.8436,
706 "longitude": -118.39177,
707 "time_zone": "America/Los_Angeles"
708 }
709 }
710 }
711 },
712 "forms": [],
713 "fees": [
714 {
715 "object": "Fee",
716 "type": "PostageFee",
717 "amount": "6.53000",
718 "charged": true,
719 "refunded": false
720 }
721 ],
722 "object": "Shipment"
723 }
724 ],
725 "rates": [
726 {
727 "id": "rate_f5c525e085fc4fba9b93b6bc98968f90",
728 "object": "Rate",
729 "created_at": null,
730 "updated_at": null,
731 "mode": "test",
732 "service": "Express",
733 "carrier": "USPS",
734 "rate": "72.55",
735 "currency": "USD",
736 "retail_rate": "83.25",
737 "retail_currency": "USD",
738 "list_rate": "72.55",
739 "list_currency": "USD",
740 "billing_type": "easypost",
741 "delivery_days": 2,
742 "delivery_date": null,
743 "delivery_date_guaranteed": false,
744 "est_delivery_days": 2,
745 "shipment_id": "shp_65e970abcfe642dabde0bea8600078c9",
746 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
747 },
748 {
749 "id": "rate_6300df44a8a3481f8b5b2655bbb1e9d1",
750 "object": "Rate",
751 "created_at": null,
752 "updated_at": null,
753 "mode": "test",
754 "service": "Priority",
755 "carrier": "USPS",
756 "rate": "15.64",
757 "currency": "USD",
758 "retail_rate": "22.55",
759 "retail_currency": "USD",
760 "list_rate": "17.41",
761 "list_currency": "USD",
762 "billing_type": "easypost",
763 "delivery_days": 2,
764 "delivery_date": null,
765 "delivery_date_guaranteed": false,
766 "est_delivery_days": 2,
767 "shipment_id": "shp_65e970abcfe642dabde0bea8600078c9",
768 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
769 },
770 {
771 "id": "rate_fae3ae6baf3043718d64763747316e57",
772 "object": "Rate",
773 "created_at": null,
774 "updated_at": null,
775 "mode": "test",
776 "service": "GroundAdvantage",
777 "carrier": "USPS",
778 "rate": "11.74",
779 "currency": "USD",
780 "retail_rate": "18.40",
781 "retail_currency": "USD",
782 "list_rate": "13.26",
783 "list_currency": "USD",
784 "billing_type": "easypost",
785 "delivery_days": 3,
786 "delivery_date": null,
787 "delivery_date_guaranteed": false,
788 "est_delivery_days": 3,
789 "shipment_id": "shp_65e970abcfe642dabde0bea8600078c9",
790 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
791 }
792 ],
793 "id": "order_f7cdd537d4174067a0c095b5b2255213",
794 "object": "Order"
795}
An Order
can be retrieved by either its id
or reference
. However it is recommended to use EasyPost's provided identifiers because uniqueness on reference
is not enforced.
1curl -X GET https://api.easypost.com/v2/orders/order_... \
2 -u "EASYPOST_API_KEY":
1{
2 "mode": "test",
3 "reference": "",
4 "is_return": false,
5 "options": {
6 "currency": "USD",
7 "payment": {
8 "type": "SENDER"
9 }
10 },
11 "messages": [],
12 "created_at": "2025-05-09T20:47:59Z",
13 "updated_at": "2025-05-09T20:47:59Z",
14 "customs_info": null,
15 "from_address": {
16 "id": "adr_e4b589432d1611f0beecac1f6bc539ae",
17 "object": "Address",
18 "created_at": "2025-05-09T20:47:59+00:00",
19 "updated_at": "2025-05-09T20:47:59+00:00",
20 "name": "EasyPost",
21 "company": null,
22 "street1": "417 Montgomery Street",
23 "street2": "5th Floor",
24 "city": "San Francisco",
25 "state": "CA",
26 "zip": "94104",
27 "country": "US",
28 "phone": "4153334445",
29 "email": "support@easypost.com",
30 "mode": "test",
31 "carrier_facility": null,
32 "residential": null,
33 "federal_tax_id": null,
34 "state_tax_id": null,
35 "verifications": {}
36 },
37 "to_address": {
38 "id": "adr_e4b3a8fe2d1611f0b9133cecef1b359e",
39 "object": "Address",
40 "created_at": "2025-05-09T20:47:59+00:00",
41 "updated_at": "2025-05-09T20:47:59+00:00",
42 "name": "Dr. Steve Brule",
43 "company": null,
44 "street1": "179 N Harbor Dr",
45 "street2": null,
46 "city": "Redondo Beach",
47 "state": "CA",
48 "zip": "90277",
49 "country": "US",
50 "phone": "8573875756",
51 "email": "dr_steve_brule@gmail.com",
52 "mode": "test",
53 "carrier_facility": null,
54 "residential": null,
55 "federal_tax_id": null,
56 "state_tax_id": null,
57 "verifications": {}
58 },
59 "buyer_address": {
60 "id": "adr_e4b3a8fe2d1611f0b9133cecef1b359e",
61 "object": "Address",
62 "created_at": "2025-05-09T20:47:59+00:00",
63 "updated_at": "2025-05-09T20:47:59+00:00",
64 "name": "Dr. Steve Brule",
65 "company": null,
66 "street1": "179 N Harbor Dr",
67 "street2": null,
68 "city": "Redondo Beach",
69 "state": "CA",
70 "zip": "90277",
71 "country": "US",
72 "phone": "8573875756",
73 "email": "dr_steve_brule@gmail.com",
74 "mode": "test",
75 "carrier_facility": null,
76 "residential": null,
77 "federal_tax_id": null,
78 "state_tax_id": null,
79 "verifications": {}
80 },
81 "return_address": {
82 "id": "adr_e4b589432d1611f0beecac1f6bc539ae",
83 "object": "Address",
84 "created_at": "2025-05-09T20:47:59+00:00",
85 "updated_at": "2025-05-09T20:47:59+00:00",
86 "name": "EasyPost",
87 "company": null,
88 "street1": "417 Montgomery Street",
89 "street2": "5th Floor",
90 "city": "San Francisco",
91 "state": "CA",
92 "zip": "94104",
93 "country": "US",
94 "phone": "4153334445",
95 "email": "support@easypost.com",
96 "mode": "test",
97 "carrier_facility": null,
98 "residential": null,
99 "federal_tax_id": null,
100 "state_tax_id": null,
101 "verifications": {}
102 },
103 "shipments": [
104 {
105 "id": "shp_03f9dca8cd284ff191d96ebace2de280",
106 "created_at": "2025-05-09T20:47:59Z",
107 "is_return": false,
108 "messages": [],
109 "mode": "test",
110 "options": {
111 "currency": "USD",
112 "payment": {
113 "type": "SENDER"
114 },
115 "date_advance": 0
116 },
117 "reference": null,
118 "status": "unknown",
119 "tracking_code": null,
120 "updated_at": "2025-05-09T20:47:59Z",
121 "batch_id": null,
122 "batch_status": null,
123 "batch_message": null,
124 "customs_info": null,
125 "from_address": {
126 "id": "adr_e4b589432d1611f0beecac1f6bc539ae",
127 "object": "Address",
128 "created_at": "2025-05-09T20:47:59+00:00",
129 "updated_at": "2025-05-09T20:47:59+00:00",
130 "name": "EasyPost",
131 "company": null,
132 "street1": "417 Montgomery Street",
133 "street2": "5th Floor",
134 "city": "San Francisco",
135 "state": "CA",
136 "zip": "94104",
137 "country": "US",
138 "phone": "4153334445",
139 "email": "support@easypost.com",
140 "mode": "test",
141 "carrier_facility": null,
142 "residential": null,
143 "federal_tax_id": null,
144 "state_tax_id": null,
145 "verifications": {}
146 },
147 "insurance": null,
148 "order_id": "order_197ce5ba9aad4da1aeddbb36f4aa1099",
149 "parcel": {
150 "id": "prcl_e6c3ea56f3724a8ca81f9ce679c000f6",
151 "object": "Parcel",
152 "created_at": "2025-05-09T20:47:59Z",
153 "updated_at": "2025-05-09T20:47:59Z",
154 "length": null,
155 "width": null,
156 "height": null,
157 "predefined_package": null,
158 "weight": 10.2,
159 "mode": "test"
160 },
161 "postage_label": null,
162 "rates": [
163 {
164 "id": "rate_b3d66b64d384420d8b554268f141208a",
165 "object": "Rate",
166 "created_at": "2025-05-09T20:47:59Z",
167 "updated_at": "2025-05-09T20:47:59Z",
168 "mode": "test",
169 "service": "Express",
170 "carrier": "USPS",
171 "rate": "34.15",
172 "currency": "USD",
173 "retail_rate": "39.10",
174 "retail_currency": "USD",
175 "list_rate": "34.15",
176 "list_currency": "USD",
177 "billing_type": "easypost",
178 "delivery_days": 2,
179 "delivery_date": null,
180 "delivery_date_guaranteed": false,
181 "est_delivery_days": 2,
182 "shipment_id": "shp_03f9dca8cd284ff191d96ebace2de280",
183 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
184 },
185 {
186 "id": "rate_81449015cc374435a7de9fcea9a40aa2",
187 "object": "Rate",
188 "created_at": "2025-05-09T20:47:59Z",
189 "updated_at": "2025-05-09T20:47:59Z",
190 "mode": "test",
191 "service": "Priority",
192 "carrier": "USPS",
193 "rate": "7.42",
194 "currency": "USD",
195 "retail_rate": "9.90",
196 "retail_currency": "USD",
197 "list_rate": "8.34",
198 "list_currency": "USD",
199 "billing_type": "easypost",
200 "delivery_days": 2,
201 "delivery_date": null,
202 "delivery_date_guaranteed": false,
203 "est_delivery_days": 2,
204 "shipment_id": "shp_03f9dca8cd284ff191d96ebace2de280",
205 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
206 },
207 {
208 "id": "rate_5af41d0b7a5c4147bcf0ea8da19dc3b3",
209 "object": "Rate",
210 "created_at": "2025-05-09T20:47:59Z",
211 "updated_at": "2025-05-09T20:47:59Z",
212 "mode": "test",
213 "service": "GroundAdvantage",
214 "carrier": "USPS",
215 "rate": "5.21",
216 "currency": "USD",
217 "retail_rate": "7.00",
218 "retail_currency": "USD",
219 "list_rate": "5.21",
220 "list_currency": "USD",
221 "billing_type": "easypost",
222 "delivery_days": 3,
223 "delivery_date": null,
224 "delivery_date_guaranteed": false,
225 "est_delivery_days": 3,
226 "shipment_id": "shp_03f9dca8cd284ff191d96ebace2de280",
227 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
228 }
229 ],
230 "refund_status": null,
231 "scan_form": null,
232 "selected_rate": null,
233 "tracker": null,
234 "to_address": {
235 "id": "adr_e4b3a8fe2d1611f0b9133cecef1b359e",
236 "object": "Address",
237 "created_at": "2025-05-09T20:47:59+00:00",
238 "updated_at": "2025-05-09T20:47:59+00:00",
239 "name": "Dr. Steve Brule",
240 "company": null,
241 "street1": "179 N Harbor Dr",
242 "street2": null,
243 "city": "Redondo Beach",
244 "state": "CA",
245 "zip": "90277",
246 "country": "US",
247 "phone": "8573875756",
248 "email": "dr_steve_brule@gmail.com",
249 "mode": "test",
250 "carrier_facility": null,
251 "residential": null,
252 "federal_tax_id": null,
253 "state_tax_id": null,
254 "verifications": {}
255 },
256 "usps_zone": 4,
257 "return_address": {
258 "id": "adr_e4b589432d1611f0beecac1f6bc539ae",
259 "object": "Address",
260 "created_at": "2025-05-09T20:47:59+00:00",
261 "updated_at": "2025-05-09T20:47:59+00:00",
262 "name": "EasyPost",
263 "company": null,
264 "street1": "417 Montgomery Street",
265 "street2": "5th Floor",
266 "city": "San Francisco",
267 "state": "CA",
268 "zip": "94104",
269 "country": "US",
270 "phone": "4153334445",
271 "email": "support@easypost.com",
272 "mode": "test",
273 "carrier_facility": null,
274 "residential": null,
275 "federal_tax_id": null,
276 "state_tax_id": null,
277 "verifications": {}
278 },
279 "buyer_address": {
280 "id": "adr_e4b3a8fe2d1611f0b9133cecef1b359e",
281 "object": "Address",
282 "created_at": "2025-05-09T20:47:59+00:00",
283 "updated_at": "2025-05-09T20:47:59+00:00",
284 "name": "Dr. Steve Brule",
285 "company": null,
286 "street1": "179 N Harbor Dr",
287 "street2": null,
288 "city": "Redondo Beach",
289 "state": "CA",
290 "zip": "90277",
291 "country": "US",
292 "phone": "8573875756",
293 "email": "dr_steve_brule@gmail.com",
294 "mode": "test",
295 "carrier_facility": null,
296 "residential": null,
297 "federal_tax_id": null,
298 "state_tax_id": null,
299 "verifications": {}
300 },
301 "forms": [],
302 "fees": [],
303 "object": "Shipment"
304 },
305 {
306 "id": "shp_91629582ae67467fb0dd82374f5e67a1",
307 "created_at": "2025-05-09T20:47:59Z",
308 "is_return": false,
309 "messages": [],
310 "mode": "test",
311 "options": {
312 "currency": "USD",
313 "payment": {
314 "type": "SENDER"
315 },
316 "date_advance": 0
317 },
318 "reference": null,
319 "status": "unknown",
320 "tracking_code": null,
321 "updated_at": "2025-05-09T20:47:59Z",
322 "batch_id": null,
323 "batch_status": null,
324 "batch_message": null,
325 "customs_info": null,
326 "from_address": {
327 "id": "adr_e4b589432d1611f0beecac1f6bc539ae",
328 "object": "Address",
329 "created_at": "2025-05-09T20:47:59+00:00",
330 "updated_at": "2025-05-09T20:47:59+00:00",
331 "name": "EasyPost",
332 "company": null,
333 "street1": "417 Montgomery Street",
334 "street2": "5th Floor",
335 "city": "San Francisco",
336 "state": "CA",
337 "zip": "94104",
338 "country": "US",
339 "phone": "4153334445",
340 "email": "support@easypost.com",
341 "mode": "test",
342 "carrier_facility": null,
343 "residential": null,
344 "federal_tax_id": null,
345 "state_tax_id": null,
346 "verifications": {}
347 },
348 "insurance": null,
349 "order_id": "order_197ce5ba9aad4da1aeddbb36f4aa1099",
350 "parcel": {
351 "id": "prcl_d58cc3609ea84a17832cdeec9d2c5c7b",
352 "object": "Parcel",
353 "created_at": "2025-05-09T20:47:59Z",
354 "updated_at": "2025-05-09T20:47:59Z",
355 "length": null,
356 "width": null,
357 "height": null,
358 "predefined_package": null,
359 "weight": 17.5,
360 "mode": "test"
361 },
362 "postage_label": null,
363 "rates": [
364 {
365 "id": "rate_099d9b9526f446b885d887ad417180a9",
366 "object": "Rate",
367 "created_at": "2025-05-09T20:48:00Z",
368 "updated_at": "2025-05-09T20:48:00Z",
369 "mode": "test",
370 "service": "GroundAdvantage",
371 "carrier": "USPS",
372 "rate": "6.53",
373 "currency": "USD",
374 "retail_rate": "11.40",
375 "retail_currency": "USD",
376 "list_rate": "8.05",
377 "list_currency": "USD",
378 "billing_type": "easypost",
379 "delivery_days": 3,
380 "delivery_date": null,
381 "delivery_date_guaranteed": false,
382 "est_delivery_days": 3,
383 "shipment_id": "shp_91629582ae67467fb0dd82374f5e67a1",
384 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
385 },
386 {
387 "id": "rate_7e41dc79473d4eba8f86335a1fd45886",
388 "object": "Rate",
389 "created_at": "2025-05-09T20:48:00Z",
390 "updated_at": "2025-05-09T20:48:00Z",
391 "mode": "test",
392 "service": "Express",
393 "carrier": "USPS",
394 "rate": "38.40",
395 "currency": "USD",
396 "retail_rate": "44.15",
397 "retail_currency": "USD",
398 "list_rate": "38.40",
399 "list_currency": "USD",
400 "billing_type": "easypost",
401 "delivery_days": 2,
402 "delivery_date": null,
403 "delivery_date_guaranteed": false,
404 "est_delivery_days": 2,
405 "shipment_id": "shp_91629582ae67467fb0dd82374f5e67a1",
406 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
407 },
408 {
409 "id": "rate_0fbc72caed0e469e97ed483a2fdcc555",
410 "object": "Rate",
411 "created_at": "2025-05-09T20:48:00Z",
412 "updated_at": "2025-05-09T20:48:00Z",
413 "mode": "test",
414 "service": "Priority",
415 "carrier": "USPS",
416 "rate": "8.22",
417 "currency": "USD",
418 "retail_rate": "12.65",
419 "retail_currency": "USD",
420 "list_rate": "9.07",
421 "list_currency": "USD",
422 "billing_type": "easypost",
423 "delivery_days": 2,
424 "delivery_date": null,
425 "delivery_date_guaranteed": false,
426 "est_delivery_days": 2,
427 "shipment_id": "shp_91629582ae67467fb0dd82374f5e67a1",
428 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
429 }
430 ],
431 "refund_status": null,
432 "scan_form": null,
433 "selected_rate": null,
434 "tracker": null,
435 "to_address": {
436 "id": "adr_e4b3a8fe2d1611f0b9133cecef1b359e",
437 "object": "Address",
438 "created_at": "2025-05-09T20:47:59+00:00",
439 "updated_at": "2025-05-09T20:47:59+00:00",
440 "name": "Dr. Steve Brule",
441 "company": null,
442 "street1": "179 N Harbor Dr",
443 "street2": null,
444 "city": "Redondo Beach",
445 "state": "CA",
446 "zip": "90277",
447 "country": "US",
448 "phone": "8573875756",
449 "email": "dr_steve_brule@gmail.com",
450 "mode": "test",
451 "carrier_facility": null,
452 "residential": null,
453 "federal_tax_id": null,
454 "state_tax_id": null,
455 "verifications": {}
456 },
457 "usps_zone": 4,
458 "return_address": {
459 "id": "adr_e4b589432d1611f0beecac1f6bc539ae",
460 "object": "Address",
461 "created_at": "2025-05-09T20:47:59+00:00",
462 "updated_at": "2025-05-09T20:47:59+00:00",
463 "name": "EasyPost",
464 "company": null,
465 "street1": "417 Montgomery Street",
466 "street2": "5th Floor",
467 "city": "San Francisco",
468 "state": "CA",
469 "zip": "94104",
470 "country": "US",
471 "phone": "4153334445",
472 "email": "support@easypost.com",
473 "mode": "test",
474 "carrier_facility": null,
475 "residential": null,
476 "federal_tax_id": null,
477 "state_tax_id": null,
478 "verifications": {}
479 },
480 "buyer_address": {
481 "id": "adr_e4b3a8fe2d1611f0b9133cecef1b359e",
482 "object": "Address",
483 "created_at": "2025-05-09T20:47:59+00:00",
484 "updated_at": "2025-05-09T20:47:59+00:00",
485 "name": "Dr. Steve Brule",
486 "company": null,
487 "street1": "179 N Harbor Dr",
488 "street2": null,
489 "city": "Redondo Beach",
490 "state": "CA",
491 "zip": "90277",
492 "country": "US",
493 "phone": "8573875756",
494 "email": "dr_steve_brule@gmail.com",
495 "mode": "test",
496 "carrier_facility": null,
497 "residential": null,
498 "federal_tax_id": null,
499 "state_tax_id": null,
500 "verifications": {}
501 },
502 "forms": [],
503 "fees": [],
504 "object": "Shipment"
505 }
506 ],
507 "rates": [
508 {
509 "id": "rate_b3d66b64d384420d8b554268f141208a",
510 "object": "Rate",
511 "created_at": null,
512 "updated_at": null,
513 "mode": "test",
514 "service": "Express",
515 "carrier": "USPS",
516 "rate": "72.55",
517 "currency": "USD",
518 "retail_rate": "83.25",
519 "retail_currency": "USD",
520 "list_rate": "72.55",
521 "list_currency": "USD",
522 "billing_type": "easypost",
523 "delivery_days": 2,
524 "delivery_date": null,
525 "delivery_date_guaranteed": false,
526 "est_delivery_days": 2,
527 "shipment_id": "shp_03f9dca8cd284ff191d96ebace2de280",
528 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
529 },
530 {
531 "id": "rate_81449015cc374435a7de9fcea9a40aa2",
532 "object": "Rate",
533 "created_at": null,
534 "updated_at": null,
535 "mode": "test",
536 "service": "Priority",
537 "carrier": "USPS",
538 "rate": "15.64",
539 "currency": "USD",
540 "retail_rate": "22.55",
541 "retail_currency": "USD",
542 "list_rate": "17.41",
543 "list_currency": "USD",
544 "billing_type": "easypost",
545 "delivery_days": 2,
546 "delivery_date": null,
547 "delivery_date_guaranteed": false,
548 "est_delivery_days": 2,
549 "shipment_id": "shp_03f9dca8cd284ff191d96ebace2de280",
550 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
551 },
552 {
553 "id": "rate_5af41d0b7a5c4147bcf0ea8da19dc3b3",
554 "object": "Rate",
555 "created_at": null,
556 "updated_at": null,
557 "mode": "test",
558 "service": "GroundAdvantage",
559 "carrier": "USPS",
560 "rate": "11.74",
561 "currency": "USD",
562 "retail_rate": "18.40",
563 "retail_currency": "USD",
564 "list_rate": "13.26",
565 "list_currency": "USD",
566 "billing_type": "easypost",
567 "delivery_days": 3,
568 "delivery_date": null,
569 "delivery_date_guaranteed": false,
570 "est_delivery_days": 3,
571 "shipment_id": "shp_03f9dca8cd284ff191d96ebace2de280",
572 "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
573 }
574 ],
575 "id": "order_197ce5ba9aad4da1aeddbb36f4aa1099",
576 "object": "Order"
577}