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.


Order object

id
string
Unique, begins with "order_"
object
string
"Order"
reference
string
An optional field that may be used in place of id in other API endpoints
mode
string
"test" or "production"
to_address
The destination address
from_address
The origin address
return_address
The shipper's address, defaults to from_address
buyer_address
The buyer's address, defaults to to_address
shipments
Shipment array
All associated Shipment objects. Maximum of 100.
customs_info
deprecated
The customs_info field at the order level is deprecated and should not be used. SpecifyCustomsInfo within each individualShipment object instead.
rates
Rate array
All associated Rate objects
messages
Message array
Any carrier errors encountered during rating
is_return
boolean
Set true to create as a return.
created_at
datetime
When the Order was created
updated_at
datetime
When the Order was last updated
Order Object
{
  "mode": "test",
  "reference": "",
  "is_return": false,
  "options": {
    "currency": "USD",
    "payment": {
      "type": "SENDER"
    }
  },
  "messages": [],
  "created_at": "2024-06-13T22:05:03Z",
  "updated_at": "2024-06-13T22:05:03Z",
  "customs_info": null,
  "from_address": {
    "id": "adr_fc21d34a29d011efb18e3cecef1b359e",
    "object": "Address",
    "created_at": "2024-06-13T22:05:03+00:00",
    "updated_at": "2024-06-13T22:05:03+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_fc2033fa29d011efb18c3cecef1b359e",
    "object": "Address",
    "created_at": "2024-06-13T22:05:03+00:00",
    "updated_at": "2024-06-13T22:05:04+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_fc2033fa29d011efb18c3cecef1b359e",
    "object": "Address",
    "created_at": "2024-06-13T22:05:03+00:00",
    "updated_at": "2024-06-13T22:05:04+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_fc21d34a29d011efb18e3cecef1b359e",
    "object": "Address",
    "created_at": "2024-06-13T22:05:03+00:00",
    "updated_at": "2024-06-13T22:05:03+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": [
    {
      "created_at": "2024-06-13T22:05:03Z",
      "is_return": false,
      "messages": [],
      "mode": "test",
      "options": {
        "currency": "USD",
        "payment": {
          "type": "SENDER"
        },
        "date_advance": 0
      },
      "reference": null,
      "status": "unknown",
      "tracking_code": "9400100110368051717318",
      "updated_at": "2024-06-13T22:05:04Z",
      "batch_id": null,
      "batch_status": null,
      "batch_message": null,
      "customs_info": null,
      "from_address": {
        "id": "adr_fc21d34a29d011efb18e3cecef1b359e",
        "object": "Address",
        "created_at": "2024-06-13T22:05:03+00:00",
        "updated_at": "2024-06-13T22:05:03+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_508547ee50c84b7dbf3b18a8c730e319",
      "parcel": {
        "id": "prcl_3d294a298e334648b747553a3d35e8cd",
        "object": "Parcel",
        "created_at": "2024-06-13T22:05:03Z",
        "updated_at": "2024-06-13T22:05:03Z",
        "length": null,
        "width": null,
        "height": null,
        "predefined_package": null,
        "weight": 10.2,
        "mode": "test"
      },
      "postage_label": {
        "object": "PostageLabel",
        "id": "pl_d9a1c49dc9564be79049f67548b67db1",
        "created_at": "2024-06-13T22:05:04Z",
        "updated_at": "2024-06-13T22:05:04Z",
        "date_advance": 0,
        "integrated_form": "none",
        "label_date": "2024-06-13T22:05:04Z",
        "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/20240613/e87dcc360df9e541cca6a31799a9a51a7c.png",
        "label_pdf_url": null,
        "label_zpl_url": null,
        "label_epl2_url": null,
        "label_file": null
      },
      "rates": [
        {
          "id": "rate_05a312e263a3484997ef78113b40ca30",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "Priority",
          "carrier": "USPS",
          "rate": "6.88",
          "currency": "USD",
          "retail_rate": "9.80",
          "retail_currency": "USD",
          "list_rate": "8.25",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 2,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 2,
          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        },
        {
          "id": "rate_9be0bf0c869945d2b18a393a7cf5bc42",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "GroundAdvantage",
          "carrier": "USPS",
          "rate": "5.07",
          "currency": "USD",
          "retail_rate": "6.70",
          "retail_currency": "USD",
          "list_rate": "5.07",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 3,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 3,
          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        },
        {
          "id": "rate_5d3e1c77fa264020a6a437dc4d9b5855",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "First",
          "carrier": "USPS",
          "rate": "5.07",
          "currency": "USD",
          "retail_rate": "6.70",
          "retail_currency": "USD",
          "list_rate": "5.07",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 3,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 3,
          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        },
        {
          "id": "rate_49810a6defee4488a186fbdae9b0b21c",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "ParcelSelect",
          "carrier": "USPS",
          "rate": "5.07",
          "currency": "USD",
          "retail_rate": "6.70",
          "retail_currency": "USD",
          "list_rate": "5.07",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 3,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 3,
          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        },
        {
          "id": "rate_3489ae08f18549d18b980f8960786a28",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "Express",
          "carrier": "USPS",
          "rate": "33.10",
          "currency": "USD",
          "retail_rate": "37.90",
          "retail_currency": "USD",
          "list_rate": "33.10",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 1,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 1,
          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        }
      ],
      "refund_status": null,
      "scan_form": null,
      "selected_rate": {
        "id": "rate_5d3e1c77fa264020a6a437dc4d9b5855",
        "object": "Rate",
        "created_at": "2024-06-13T22:05:04Z",
        "updated_at": "2024-06-13T22:05:04Z",
        "mode": "test",
        "service": "First",
        "carrier": "USPS",
        "rate": "5.07",
        "currency": "USD",
        "retail_rate": "6.70",
        "retail_currency": "USD",
        "list_rate": "5.07",
        "list_currency": "USD",
        "billing_type": "easypost",
        "delivery_days": 3,
        "delivery_date": null,
        "delivery_date_guaranteed": false,
        "est_delivery_days": 3,
        "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
        "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
      },
      "tracker": {
        "id": "trk_873514a9423145efbff4d02a1359c430",
        "object": "Tracker",
        "mode": "test",
        "tracking_code": "9400100110368051717318",
        "status": "unknown",
        "status_detail": "unknown",
        "created_at": "2024-06-13T22:05:05Z",
        "updated_at": "2024-06-13T22:05:05Z",
        "signed_by": null,
        "weight": null,
        "est_delivery_date": null,
        "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
        "carrier": "USPS",
        "tracking_details": [],
        "fees": [],
        "carrier_detail": null,
        "public_url": "https://track.easypost.com/djE6dHJrXzg3MzUxNGE5NDIzMTQ1ZWZiZmY0ZDAyYTEzNTljNDMw"
      },
      "to_address": {
        "id": "adr_fc2033fa29d011efb18c3cecef1b359e",
        "object": "Address",
        "created_at": "2024-06-13T22:05:03+00:00",
        "updated_at": "2024-06-13T22:05:04+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_fc21d34a29d011efb18e3cecef1b359e",
        "object": "Address",
        "created_at": "2024-06-13T22:05:03+00:00",
        "updated_at": "2024-06-13T22:05:03+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_fc2033fa29d011efb18c3cecef1b359e",
        "object": "Address",
        "created_at": "2024-06-13T22:05:03+00:00",
        "updated_at": "2024-06-13T22:05:04+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": "LabelFee",
          "amount": "0.00000",
          "charged": true,
          "refunded": false
        },
        {
          "object": "Fee",
          "type": "PostageFee",
          "amount": "5.07000",
          "charged": true,
          "refunded": false
        }
      ],
      "id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
      "object": "Shipment"
    },
    {
      "created_at": "2024-06-13T22:05:03Z",
      "is_return": false,
      "messages": [],
      "mode": "test",
      "options": {
        "currency": "USD",
        "payment": {
          "type": "SENDER"
        },
        "date_advance": 0
      },
      "reference": null,
      "status": "unknown",
      "tracking_code": "9434600110368051717327",
      "updated_at": "2024-06-13T22:05:04Z",
      "batch_id": null,
      "batch_status": null,
      "batch_message": null,
      "customs_info": null,
      "from_address": {
        "id": "adr_fc21d34a29d011efb18e3cecef1b359e",
        "object": "Address",
        "created_at": "2024-06-13T22:05:03+00:00",
        "updated_at": "2024-06-13T22:05:03+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_508547ee50c84b7dbf3b18a8c730e319",
      "parcel": {
        "id": "prcl_fd5826adad704aa6bed4a374c2b3726c",
        "object": "Parcel",
        "created_at": "2024-06-13T22:05:03Z",
        "updated_at": "2024-06-13T22:05:03Z",
        "length": null,
        "width": null,
        "height": null,
        "predefined_package": null,
        "weight": 17.5,
        "mode": "test"
      },
      "postage_label": {
        "object": "PostageLabel",
        "id": "pl_feb0e9c071fb47989acaead04158cdf1",
        "created_at": "2024-06-13T22:05:04Z",
        "updated_at": "2024-06-13T22:05:04Z",
        "date_advance": 0,
        "integrated_form": "none",
        "label_date": "2024-06-13T22:05:04Z",
        "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/20240613/e858834ae57691479f9f0e4ebd0ae943b6.png",
        "label_pdf_url": null,
        "label_zpl_url": null,
        "label_epl2_url": null,
        "label_file": null
      },
      "rates": [
        {
          "id": "rate_0c3e55c07ccd47169b24a6e81cbddc2f",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "GroundAdvantage",
          "carrier": "USPS",
          "rate": "6.26",
          "currency": "USD",
          "retail_rate": "10.80",
          "retail_currency": "USD",
          "list_rate": "7.75",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 3,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 3,
          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        },
        {
          "id": "rate_0b948416fe4a4d069cc520494c7e1403",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "First",
          "carrier": "USPS",
          "rate": "6.26",
          "currency": "USD",
          "retail_rate": "10.80",
          "retail_currency": "USD",
          "list_rate": "7.75",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 3,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 3,
          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        },
        {
          "id": "rate_cc13e8bd6c88434baa68c8edb288ab63",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "ParcelSelect",
          "carrier": "USPS",
          "rate": "6.26",
          "currency": "USD",
          "retail_rate": "10.80",
          "retail_currency": "USD",
          "list_rate": "7.75",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 3,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 3,
          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        },
        {
          "id": "rate_597402f87a2a484382414d0d55c923eb",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "Express",
          "carrier": "USPS",
          "rate": "37.20",
          "currency": "USD",
          "retail_rate": "42.80",
          "retail_currency": "USD",
          "list_rate": "37.20",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 1,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 1,
          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        },
        {
          "id": "rate_c3a7609bb25d4c9ebd3967e1c03f0f1d",
          "object": "Rate",
          "created_at": "2024-06-13T22:05:03Z",
          "updated_at": "2024-06-13T22:05:03Z",
          "mode": "test",
          "service": "Priority",
          "carrier": "USPS",
          "rate": "6.91",
          "currency": "USD",
          "retail_rate": "12.50",
          "retail_currency": "USD",
          "list_rate": "8.97",
          "list_currency": "USD",
          "billing_type": "easypost",
          "delivery_days": 2,
          "delivery_date": null,
          "delivery_date_guaranteed": false,
          "est_delivery_days": 2,
          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
        }
      ],
      "refund_status": null,
      "scan_form": null,
      "selected_rate": {
        "id": "rate_0b948416fe4a4d069cc520494c7e1403",
        "object": "Rate",
        "created_at": "2024-06-13T22:05:04Z",
        "updated_at": "2024-06-13T22:05:04Z",
        "mode": "test",
        "service": "First",
        "carrier": "USPS",
        "rate": "6.26",
        "currency": "USD",
        "retail_rate": "10.80",
        "retail_currency": "USD",
        "list_rate": "7.75",
        "list_currency": "USD",
        "billing_type": "easypost",
        "delivery_days": 3,
        "delivery_date": null,
        "delivery_date_guaranteed": false,
        "est_delivery_days": 3,
        "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
        "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
      },
      "tracker": {
        "id": "trk_efe0f8df84ae4ad89202ae51e70772b9",
        "object": "Tracker",
        "mode": "test",
        "tracking_code": "9434600110368051717327",
        "status": "unknown",
        "status_detail": "unknown",
        "created_at": "2024-06-13T22:05:05Z",
        "updated_at": "2024-06-13T22:05:05Z",
        "signed_by": null,
        "weight": null,
        "est_delivery_date": null,
        "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
        "carrier": "USPS",
        "tracking_details": [],
        "fees": [],
        "carrier_detail": null,
        "public_url": "https://track.easypost.com/djE6dHJrX2VmZTBmOGRmODRhZTRhZDg5MjAyYWU1MWU3MDc3MmI5"
      },
      "to_address": {
        "id": "adr_fc2033fa29d011efb18c3cecef1b359e",
        "object": "Address",
        "created_at": "2024-06-13T22:05:03+00:00",
        "updated_at": "2024-06-13T22:05:04+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_fc21d34a29d011efb18e3cecef1b359e",
        "object": "Address",
        "created_at": "2024-06-13T22:05:03+00:00",
        "updated_at": "2024-06-13T22:05:03+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_fc2033fa29d011efb18c3cecef1b359e",
        "object": "Address",
        "created_at": "2024-06-13T22:05:03+00:00",
        "updated_at": "2024-06-13T22:05:04+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": "LabelFee",
          "amount": "0.00000",
          "charged": true,
          "refunded": false
        },
        {
          "object": "Fee",
          "type": "PostageFee",
          "amount": "6.26000",
          "charged": true,
          "refunded": false
        }
      ],
      "id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
      "object": "Shipment"
    }
  ],
  "rates": [
    {
      "id": "rate_05a312e263a3484997ef78113b40ca30",
      "object": "Rate",
      "created_at": null,
      "updated_at": null,
      "mode": "test",
      "service": "Priority",
      "carrier": "USPS",
      "rate": "13.79",
      "currency": "USD",
      "retail_rate": "22.30",
      "retail_currency": "USD",
      "list_rate": "17.22",
      "list_currency": "USD",
      "billing_type": "easypost",
      "delivery_days": 2,
      "delivery_date": null,
      "delivery_date_guaranteed": false,
      "est_delivery_days": 2,
      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
    },
    {
      "id": "rate_9be0bf0c869945d2b18a393a7cf5bc42",
      "object": "Rate",
      "created_at": null,
      "updated_at": null,
      "mode": "test",
      "service": "GroundAdvantage",
      "carrier": "USPS",
      "rate": "11.33",
      "currency": "USD",
      "retail_rate": "17.50",
      "retail_currency": "USD",
      "list_rate": "12.82",
      "list_currency": "USD",
      "billing_type": "easypost",
      "delivery_days": 3,
      "delivery_date": null,
      "delivery_date_guaranteed": false,
      "est_delivery_days": 3,
      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
    },
    {
      "id": "rate_5d3e1c77fa264020a6a437dc4d9b5855",
      "object": "Rate",
      "created_at": null,
      "updated_at": null,
      "mode": "test",
      "service": "First",
      "carrier": "USPS",
      "rate": "11.33",
      "currency": "USD",
      "retail_rate": "17.50",
      "retail_currency": "USD",
      "list_rate": "12.82",
      "list_currency": "USD",
      "billing_type": "easypost",
      "delivery_days": 3,
      "delivery_date": null,
      "delivery_date_guaranteed": false,
      "est_delivery_days": 3,
      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
    },
    {
      "id": "rate_49810a6defee4488a186fbdae9b0b21c",
      "object": "Rate",
      "created_at": null,
      "updated_at": null,
      "mode": "test",
      "service": "ParcelSelect",
      "carrier": "USPS",
      "rate": "11.33",
      "currency": "USD",
      "retail_rate": "17.50",
      "retail_currency": "USD",
      "list_rate": "12.82",
      "list_currency": "USD",
      "billing_type": "easypost",
      "delivery_days": 3,
      "delivery_date": null,
      "delivery_date_guaranteed": false,
      "est_delivery_days": 3,
      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
    },
    {
      "id": "rate_3489ae08f18549d18b980f8960786a28",
      "object": "Rate",
      "created_at": null,
      "updated_at": null,
      "mode": "test",
      "service": "Express",
      "carrier": "USPS",
      "rate": "70.30",
      "currency": "USD",
      "retail_rate": "80.70",
      "retail_currency": "USD",
      "list_rate": "70.30",
      "list_currency": "USD",
      "billing_type": "easypost",
      "delivery_days": 1,
      "delivery_date": null,
      "delivery_date_guaranteed": false,
      "est_delivery_days": 1,
      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
    }
  ],
  "id": "order_508547ee50c84b7dbf3b18a8c730e319",
  "object": "Order"
}

Create an 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

reference
i.e. "my-reference"
to_address
i.e. Address
Can be specified by ID or attributes to create a new one, and be verified inline. See Create an Address
from_address
i.e. Address
Can be specified by ID or attributes to create a new one, and be verified inline. See Create an Address
shipments
i.e. Shipment array
List of shipments
carrier_accounts
i.e. [{"id": "ca_..."}, ...]
List of carrier accounts
POST /orders
1curl -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  }'
Response
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": "2024-06-13T22:05:01Z",
13  "updated_at": "2024-06-13T22:05:01Z",
14  "customs_info": null,
15  "from_address": {
16    "id": "adr_fb52d30b29d011ef870eac1f6bc539ae",
17    "object": "Address",
18    "created_at": "2024-06-13T22:05:01+00:00",
19    "updated_at": "2024-06-13T22:05:01+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_fb50d68d29d011efa0deac1f6bc53342",
39    "object": "Address",
40    "created_at": "2024-06-13T22:05:01+00:00",
41    "updated_at": "2024-06-13T22:05:01+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_fb50d68d29d011efa0deac1f6bc53342",
61    "object": "Address",
62    "created_at": "2024-06-13T22:05:01+00:00",
63    "updated_at": "2024-06-13T22:05:01+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_fb52d30b29d011ef870eac1f6bc539ae",
83    "object": "Address",
84    "created_at": "2024-06-13T22:05:01+00:00",
85    "updated_at": "2024-06-13T22:05:01+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      "created_at": "2024-06-13T22:05:01Z",
106      "is_return": false,
107      "messages": [],
108      "mode": "test",
109      "options": {
110        "currency": "USD",
111        "payment": {
112          "type": "SENDER"
113        },
114        "date_advance": 0
115      },
116      "reference": null,
117      "status": "unknown",
118      "tracking_code": null,
119      "updated_at": "2024-06-13T22:05:01Z",
120      "batch_id": null,
121      "batch_status": null,
122      "batch_message": null,
123      "customs_info": null,
124      "from_address": {
125        "id": "adr_fb52d30b29d011ef870eac1f6bc539ae",
126        "object": "Address",
127        "created_at": "2024-06-13T22:05:01+00:00",
128        "updated_at": "2024-06-13T22:05:01+00:00",
129        "name": "EasyPost",
130        "company": null,
131        "street1": "417 Montgomery Street",
132        "street2": "5th Floor",
133        "city": "San Francisco",
134        "state": "CA",
135        "zip": "94104",
136        "country": "US",
137        "phone": "4153334445",
138        "email": "support@easypost.com",
139        "mode": "test",
140        "carrier_facility": null,
141        "residential": null,
142        "federal_tax_id": null,
143        "state_tax_id": null,
144        "verifications": {}
145      },
146      "insurance": null,
147      "order_id": "order_8c7645642ad94ed49e2c8da41b9471d6",
148      "parcel": {
149        "id": "prcl_9464c815c817405c8f58ab75f6dd255d",
150        "object": "Parcel",
151        "created_at": "2024-06-13T22:05:01Z",
152        "updated_at": "2024-06-13T22:05:01Z",
153        "length": null,
154        "width": null,
155        "height": null,
156        "predefined_package": null,
157        "weight": 10.2,
158        "mode": "test"
159      },
160      "postage_label": null,
161      "rates": [
162        {
163          "id": "rate_d10494134eae4b92baf6d49c95f16d02",
164          "object": "Rate",
165          "created_at": "2024-06-13T22:05:02Z",
166          "updated_at": "2024-06-13T22:05:02Z",
167          "mode": "test",
168          "service": "Express",
169          "carrier": "USPS",
170          "rate": "33.10",
171          "currency": "USD",
172          "retail_rate": "37.90",
173          "retail_currency": "USD",
174          "list_rate": "33.10",
175          "list_currency": "USD",
176          "billing_type": "easypost",
177          "delivery_days": 1,
178          "delivery_date": null,
179          "delivery_date_guaranteed": false,
180          "est_delivery_days": 1,
181          "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
182          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
183        },
184        {
185          "id": "rate_58671c57f0b14cceaf59b938317e4837",
186          "object": "Rate",
187          "created_at": "2024-06-13T22:05:02Z",
188          "updated_at": "2024-06-13T22:05:02Z",
189          "mode": "test",
190          "service": "Priority",
191          "carrier": "USPS",
192          "rate": "6.88",
193          "currency": "USD",
194          "retail_rate": "9.80",
195          "retail_currency": "USD",
196          "list_rate": "8.25",
197          "list_currency": "USD",
198          "billing_type": "easypost",
199          "delivery_days": 2,
200          "delivery_date": null,
201          "delivery_date_guaranteed": false,
202          "est_delivery_days": 2,
203          "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
204          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
205        },
206        {
207          "id": "rate_c43adfae42c34f869019280d51e02105",
208          "object": "Rate",
209          "created_at": "2024-06-13T22:05:02Z",
210          "updated_at": "2024-06-13T22:05:02Z",
211          "mode": "test",
212          "service": "GroundAdvantage",
213          "carrier": "USPS",
214          "rate": "5.07",
215          "currency": "USD",
216          "retail_rate": "6.70",
217          "retail_currency": "USD",
218          "list_rate": "5.07",
219          "list_currency": "USD",
220          "billing_type": "easypost",
221          "delivery_days": 3,
222          "delivery_date": null,
223          "delivery_date_guaranteed": false,
224          "est_delivery_days": 3,
225          "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
226          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
227        },
228        {
229          "id": "rate_015d1d71e3b047999de4da942e4e0cab",
230          "object": "Rate",
231          "created_at": "2024-06-13T22:05:02Z",
232          "updated_at": "2024-06-13T22:05:02Z",
233          "mode": "test",
234          "service": "First",
235          "carrier": "USPS",
236          "rate": "5.07",
237          "currency": "USD",
238          "retail_rate": "6.70",
239          "retail_currency": "USD",
240          "list_rate": "5.07",
241          "list_currency": "USD",
242          "billing_type": "easypost",
243          "delivery_days": 3,
244          "delivery_date": null,
245          "delivery_date_guaranteed": false,
246          "est_delivery_days": 3,
247          "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
248          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
249        },
250        {
251          "id": "rate_7a1919778d25413ba912c8b2751a3db3",
252          "object": "Rate",
253          "created_at": "2024-06-13T22:05:02Z",
254          "updated_at": "2024-06-13T22:05:02Z",
255          "mode": "test",
256          "service": "ParcelSelect",
257          "carrier": "USPS",
258          "rate": "5.07",
259          "currency": "USD",
260          "retail_rate": "6.70",
261          "retail_currency": "USD",
262          "list_rate": "5.07",
263          "list_currency": "USD",
264          "billing_type": "easypost",
265          "delivery_days": 3,
266          "delivery_date": null,
267          "delivery_date_guaranteed": false,
268          "est_delivery_days": 3,
269          "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
270          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
271        }
272      ],
273      "refund_status": null,
274      "scan_form": null,
275      "selected_rate": null,
276      "tracker": null,
277      "to_address": {
278        "id": "adr_fb50d68d29d011efa0deac1f6bc53342",
279        "object": "Address",
280        "created_at": "2024-06-13T22:05:01+00:00",
281        "updated_at": "2024-06-13T22:05:01+00:00",
282        "name": "Dr. Steve Brule",
283        "company": null,
284        "street1": "179 N Harbor Dr",
285        "street2": null,
286        "city": "Redondo Beach",
287        "state": "CA",
288        "zip": "90277",
289        "country": "US",
290        "phone": "8573875756",
291        "email": "dr_steve_brule@gmail.com",
292        "mode": "test",
293        "carrier_facility": null,
294        "residential": null,
295        "federal_tax_id": null,
296        "state_tax_id": null,
297        "verifications": {}
298      },
299      "usps_zone": 4,
300      "return_address": {
301        "id": "adr_fb52d30b29d011ef870eac1f6bc539ae",
302        "object": "Address",
303        "created_at": "2024-06-13T22:05:01+00:00",
304        "updated_at": "2024-06-13T22:05:01+00:00",
305        "name": "EasyPost",
306        "company": null,
307        "street1": "417 Montgomery Street",
308        "street2": "5th Floor",
309        "city": "San Francisco",
310        "state": "CA",
311        "zip": "94104",
312        "country": "US",
313        "phone": "4153334445",
314        "email": "support@easypost.com",
315        "mode": "test",
316        "carrier_facility": null,
317        "residential": null,
318        "federal_tax_id": null,
319        "state_tax_id": null,
320        "verifications": {}
321      },
322      "buyer_address": {
323        "id": "adr_fb50d68d29d011efa0deac1f6bc53342",
324        "object": "Address",
325        "created_at": "2024-06-13T22:05:01+00:00",
326        "updated_at": "2024-06-13T22:05:01+00:00",
327        "name": "Dr. Steve Brule",
328        "company": null,
329        "street1": "179 N Harbor Dr",
330        "street2": null,
331        "city": "Redondo Beach",
332        "state": "CA",
333        "zip": "90277",
334        "country": "US",
335        "phone": "8573875756",
336        "email": "dr_steve_brule@gmail.com",
337        "mode": "test",
338        "carrier_facility": null,
339        "residential": null,
340        "federal_tax_id": null,
341        "state_tax_id": null,
342        "verifications": {}
343      },
344      "forms": [],
345      "fees": [],
346      "id": "shp_ee2e9274571f41f289c1d93c247085f5",
347      "object": "Shipment"
348    },
349    {
350      "created_at": "2024-06-13T22:05:01Z",
351      "is_return": false,
352      "messages": [],
353      "mode": "test",
354      "options": {
355        "currency": "USD",
356        "payment": {
357          "type": "SENDER"
358        },
359        "date_advance": 0
360      },
361      "reference": null,
362      "status": "unknown",
363      "tracking_code": null,
364      "updated_at": "2024-06-13T22:05:01Z",
365      "batch_id": null,
366      "batch_status": null,
367      "batch_message": null,
368      "customs_info": null,
369      "from_address": {
370        "id": "adr_fb52d30b29d011ef870eac1f6bc539ae",
371        "object": "Address",
372        "created_at": "2024-06-13T22:05:01+00:00",
373        "updated_at": "2024-06-13T22:05:01+00:00",
374        "name": "EasyPost",
375        "company": null,
376        "street1": "417 Montgomery Street",
377        "street2": "5th Floor",
378        "city": "San Francisco",
379        "state": "CA",
380        "zip": "94104",
381        "country": "US",
382        "phone": "4153334445",
383        "email": "support@easypost.com",
384        "mode": "test",
385        "carrier_facility": null,
386        "residential": null,
387        "federal_tax_id": null,
388        "state_tax_id": null,
389        "verifications": {}
390      },
391      "insurance": null,
392      "order_id": "order_8c7645642ad94ed49e2c8da41b9471d6",
393      "parcel": {
394        "id": "prcl_e03ffd6401124998bf1d5bd2aecee96d",
395        "object": "Parcel",
396        "created_at": "2024-06-13T22:05:01Z",
397        "updated_at": "2024-06-13T22:05:01Z",
398        "length": null,
399        "width": null,
400        "height": null,
401        "predefined_package": null,
402        "weight": 17.5,
403        "mode": "test"
404      },
405      "postage_label": null,
406      "rates": [
407        {
408          "id": "rate_09815abd6f35425cb7f7dd9162945001",
409          "object": "Rate",
410          "created_at": "2024-06-13T22:05:02Z",
411          "updated_at": "2024-06-13T22:05:02Z",
412          "mode": "test",
413          "service": "Priority",
414          "carrier": "USPS",
415          "rate": "6.91",
416          "currency": "USD",
417          "retail_rate": "12.50",
418          "retail_currency": "USD",
419          "list_rate": "8.97",
420          "list_currency": "USD",
421          "billing_type": "easypost",
422          "delivery_days": 2,
423          "delivery_date": null,
424          "delivery_date_guaranteed": false,
425          "est_delivery_days": 2,
426          "shipment_id": "shp_c5d4f2d1cf2640df89c232a0efb537eb",
427          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
428        },
429        {
430          "id": "rate_d9c71ce5f1ee4833aa34cee01b2f5ef9",
431          "object": "Rate",
432          "created_at": "2024-06-13T22:05:02Z",
433          "updated_at": "2024-06-13T22:05:02Z",
434          "mode": "test",
435          "service": "GroundAdvantage",
436          "carrier": "USPS",
437          "rate": "6.26",
438          "currency": "USD",
439          "retail_rate": "10.80",
440          "retail_currency": "USD",
441          "list_rate": "7.75",
442          "list_currency": "USD",
443          "billing_type": "easypost",
444          "delivery_days": 3,
445          "delivery_date": null,
446          "delivery_date_guaranteed": false,
447          "est_delivery_days": 3,
448          "shipment_id": "shp_c5d4f2d1cf2640df89c232a0efb537eb",
449          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
450        },
451        {
452          "id": "rate_901f519033954d6d872cda4bdac13636",
453          "object": "Rate",
454          "created_at": "2024-06-13T22:05:02Z",
455          "updated_at": "2024-06-13T22:05:02Z",
456          "mode": "test",
457          "service": "First",
458          "carrier": "USPS",
459          "rate": "6.26",
460          "currency": "USD",
461          "retail_rate": "10.80",
462          "retail_currency": "USD",
463          "list_rate": "7.75",
464          "list_currency": "USD",
465          "billing_type": "easypost",
466          "delivery_days": 3,
467          "delivery_date": null,
468          "delivery_date_guaranteed": false,
469          "est_delivery_days": 3,
470          "shipment_id": "shp_c5d4f2d1cf2640df89c232a0efb537eb",
471          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
472        },
473        {
474          "id": "rate_9fae47cf15494ec1b6123a05b87fa3cb",
475          "object": "Rate",
476          "created_at": "2024-06-13T22:05:02Z",
477          "updated_at": "2024-06-13T22:05:02Z",
478          "mode": "test",
479          "service": "ParcelSelect",
480          "carrier": "USPS",
481          "rate": "6.26",
482          "currency": "USD",
483          "retail_rate": "10.80",
484          "retail_currency": "USD",
485          "list_rate": "7.75",
486          "list_currency": "USD",
487          "billing_type": "easypost",
488          "delivery_days": 3,
489          "delivery_date": null,
490          "delivery_date_guaranteed": false,
491          "est_delivery_days": 3,
492          "shipment_id": "shp_c5d4f2d1cf2640df89c232a0efb537eb",
493          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
494        },
495        {
496          "id": "rate_ec27502ff296407dbafb6dff6af7248d",
497          "object": "Rate",
498          "created_at": "2024-06-13T22:05:02Z",
499          "updated_at": "2024-06-13T22:05:02Z",
500          "mode": "test",
501          "service": "Express",
502          "carrier": "USPS",
503          "rate": "37.20",
504          "currency": "USD",
505          "retail_rate": "42.80",
506          "retail_currency": "USD",
507          "list_rate": "37.20",
508          "list_currency": "USD",
509          "billing_type": "easypost",
510          "delivery_days": 1,
511          "delivery_date": null,
512          "delivery_date_guaranteed": false,
513          "est_delivery_days": 1,
514          "shipment_id": "shp_c5d4f2d1cf2640df89c232a0efb537eb",
515          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
516        }
517      ],
518      "refund_status": null,
519      "scan_form": null,
520      "selected_rate": null,
521      "tracker": null,
522      "to_address": {
523        "id": "adr_fb50d68d29d011efa0deac1f6bc53342",
524        "object": "Address",
525        "created_at": "2024-06-13T22:05:01+00:00",
526        "updated_at": "2024-06-13T22:05:01+00:00",
527        "name": "Dr. Steve Brule",
528        "company": null,
529        "street1": "179 N Harbor Dr",
530        "street2": null,
531        "city": "Redondo Beach",
532        "state": "CA",
533        "zip": "90277",
534        "country": "US",
535        "phone": "8573875756",
536        "email": "dr_steve_brule@gmail.com",
537        "mode": "test",
538        "carrier_facility": null,
539        "residential": null,
540        "federal_tax_id": null,
541        "state_tax_id": null,
542        "verifications": {}
543      },
544      "usps_zone": 4,
545      "return_address": {
546        "id": "adr_fb52d30b29d011ef870eac1f6bc539ae",
547        "object": "Address",
548        "created_at": "2024-06-13T22:05:01+00:00",
549        "updated_at": "2024-06-13T22:05:01+00:00",
550        "name": "EasyPost",
551        "company": null,
552        "street1": "417 Montgomery Street",
553        "street2": "5th Floor",
554        "city": "San Francisco",
555        "state": "CA",
556        "zip": "94104",
557        "country": "US",
558        "phone": "4153334445",
559        "email": "support@easypost.com",
560        "mode": "test",
561        "carrier_facility": null,
562        "residential": null,
563        "federal_tax_id": null,
564        "state_tax_id": null,
565        "verifications": {}
566      },
567      "buyer_address": {
568        "id": "adr_fb50d68d29d011efa0deac1f6bc53342",
569        "object": "Address",
570        "created_at": "2024-06-13T22:05:01+00:00",
571        "updated_at": "2024-06-13T22:05:01+00:00",
572        "name": "Dr. Steve Brule",
573        "company": null,
574        "street1": "179 N Harbor Dr",
575        "street2": null,
576        "city": "Redondo Beach",
577        "state": "CA",
578        "zip": "90277",
579        "country": "US",
580        "phone": "8573875756",
581        "email": "dr_steve_brule@gmail.com",
582        "mode": "test",
583        "carrier_facility": null,
584        "residential": null,
585        "federal_tax_id": null,
586        "state_tax_id": null,
587        "verifications": {}
588      },
589      "forms": [],
590      "fees": [],
591      "id": "shp_c5d4f2d1cf2640df89c232a0efb537eb",
592      "object": "Shipment"
593    }
594  ],
595  "rates": [
596    {
597      "id": "rate_d10494134eae4b92baf6d49c95f16d02",
598      "object": "Rate",
599      "created_at": null,
600      "updated_at": null,
601      "mode": "test",
602      "service": "Express",
603      "carrier": "USPS",
604      "rate": "70.30",
605      "currency": "USD",
606      "retail_rate": "80.70",
607      "retail_currency": "USD",
608      "list_rate": "70.30",
609      "list_currency": "USD",
610      "billing_type": "easypost",
611      "delivery_days": 1,
612      "delivery_date": null,
613      "delivery_date_guaranteed": false,
614      "est_delivery_days": 1,
615      "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
616      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
617    },
618    {
619      "id": "rate_58671c57f0b14cceaf59b938317e4837",
620      "object": "Rate",
621      "created_at": null,
622      "updated_at": null,
623      "mode": "test",
624      "service": "Priority",
625      "carrier": "USPS",
626      "rate": "13.79",
627      "currency": "USD",
628      "retail_rate": "22.30",
629      "retail_currency": "USD",
630      "list_rate": "17.22",
631      "list_currency": "USD",
632      "billing_type": "easypost",
633      "delivery_days": 2,
634      "delivery_date": null,
635      "delivery_date_guaranteed": false,
636      "est_delivery_days": 2,
637      "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
638      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
639    },
640    {
641      "id": "rate_c43adfae42c34f869019280d51e02105",
642      "object": "Rate",
643      "created_at": null,
644      "updated_at": null,
645      "mode": "test",
646      "service": "GroundAdvantage",
647      "carrier": "USPS",
648      "rate": "11.33",
649      "currency": "USD",
650      "retail_rate": "17.50",
651      "retail_currency": "USD",
652      "list_rate": "12.82",
653      "list_currency": "USD",
654      "billing_type": "easypost",
655      "delivery_days": 3,
656      "delivery_date": null,
657      "delivery_date_guaranteed": false,
658      "est_delivery_days": 3,
659      "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
660      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
661    },
662    {
663      "id": "rate_015d1d71e3b047999de4da942e4e0cab",
664      "object": "Rate",
665      "created_at": null,
666      "updated_at": null,
667      "mode": "test",
668      "service": "First",
669      "carrier": "USPS",
670      "rate": "11.33",
671      "currency": "USD",
672      "retail_rate": "17.50",
673      "retail_currency": "USD",
674      "list_rate": "12.82",
675      "list_currency": "USD",
676      "billing_type": "easypost",
677      "delivery_days": 3,
678      "delivery_date": null,
679      "delivery_date_guaranteed": false,
680      "est_delivery_days": 3,
681      "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
682      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
683    },
684    {
685      "id": "rate_7a1919778d25413ba912c8b2751a3db3",
686      "object": "Rate",
687      "created_at": null,
688      "updated_at": null,
689      "mode": "test",
690      "service": "ParcelSelect",
691      "carrier": "USPS",
692      "rate": "11.33",
693      "currency": "USD",
694      "retail_rate": "17.50",
695      "retail_currency": "USD",
696      "list_rate": "12.82",
697      "list_currency": "USD",
698      "billing_type": "easypost",
699      "delivery_days": 3,
700      "delivery_date": null,
701      "delivery_date_guaranteed": false,
702      "est_delivery_days": 3,
703      "shipment_id": "shp_ee2e9274571f41f289c1d93c247085f5",
704      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
705    }
706  ],
707  "id": "order_8c7645642ad94ed49e2c8da41b9471d6",
708  "object": "Order"
709}

Buy an Order

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

carrier
i.e. "FedEx"
service
i.e. "FEDEX_GROUND"
POST /orders/:id/buy
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  }'
Response
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": "2024-06-13T22:05:03Z",
13  "updated_at": "2024-06-13T22:05:03Z",
14  "customs_info": null,
15  "from_address": {
16    "id": "adr_fc21d34a29d011efb18e3cecef1b359e",
17    "object": "Address",
18    "created_at": "2024-06-13T22:05:03+00:00",
19    "updated_at": "2024-06-13T22:05:03+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_fc2033fa29d011efb18c3cecef1b359e",
39    "object": "Address",
40    "created_at": "2024-06-13T22:05:03+00:00",
41    "updated_at": "2024-06-13T22:05:04+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_fc2033fa29d011efb18c3cecef1b359e",
76    "object": "Address",
77    "created_at": "2024-06-13T22:05:03+00:00",
78    "updated_at": "2024-06-13T22:05:04+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_fc21d34a29d011efb18e3cecef1b359e",
113    "object": "Address",
114    "created_at": "2024-06-13T22:05:03+00:00",
115    "updated_at": "2024-06-13T22:05:03+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      "created_at": "2024-06-13T22:05:03Z",
136      "is_return": false,
137      "messages": [],
138      "mode": "test",
139      "options": {
140        "currency": "USD",
141        "payment": {
142          "type": "SENDER"
143        },
144        "date_advance": 0
145      },
146      "reference": null,
147      "status": "unknown",
148      "tracking_code": "9400100110368051717318",
149      "updated_at": "2024-06-13T22:05:04Z",
150      "batch_id": null,
151      "batch_status": null,
152      "batch_message": null,
153      "customs_info": null,
154      "from_address": {
155        "id": "adr_fc21d34a29d011efb18e3cecef1b359e",
156        "object": "Address",
157        "created_at": "2024-06-13T22:05:03+00:00",
158        "updated_at": "2024-06-13T22:05:03+00:00",
159        "name": "EasyPost",
160        "company": null,
161        "street1": "417 Montgomery Street",
162        "street2": "5th Floor",
163        "city": "San Francisco",
164        "state": "CA",
165        "zip": "94104",
166        "country": "US",
167        "phone": "4153334445",
168        "email": "support@easypost.com",
169        "mode": "test",
170        "carrier_facility": null,
171        "residential": null,
172        "federal_tax_id": null,
173        "state_tax_id": null,
174        "verifications": {}
175      },
176      "insurance": null,
177      "order_id": "order_508547ee50c84b7dbf3b18a8c730e319",
178      "parcel": {
179        "id": "prcl_3d294a298e334648b747553a3d35e8cd",
180        "object": "Parcel",
181        "created_at": "2024-06-13T22:05:03Z",
182        "updated_at": "2024-06-13T22:05:03Z",
183        "length": null,
184        "width": null,
185        "height": null,
186        "predefined_package": null,
187        "weight": 10.2,
188        "mode": "test"
189      },
190      "postage_label": {
191        "object": "PostageLabel",
192        "id": "pl_d9a1c49dc9564be79049f67548b67db1",
193        "created_at": "2024-06-13T22:05:04Z",
194        "updated_at": "2024-06-13T22:05:04Z",
195        "date_advance": 0,
196        "integrated_form": "none",
197        "label_date": "2024-06-13T22:05:04Z",
198        "label_resolution": 300,
199        "label_size": "4x6",
200        "label_type": "default",
201        "label_file_type": "image/png",
202        "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20240613/e87dcc360df9e541cca6a31799a9a51a7c.png",
203        "label_pdf_url": null,
204        "label_zpl_url": null,
205        "label_epl2_url": null,
206        "label_file": null
207      },
208      "rates": [
209        {
210          "id": "rate_05a312e263a3484997ef78113b40ca30",
211          "object": "Rate",
212          "created_at": "2024-06-13T22:05:03Z",
213          "updated_at": "2024-06-13T22:05:03Z",
214          "mode": "test",
215          "service": "Priority",
216          "carrier": "USPS",
217          "rate": "6.88",
218          "currency": "USD",
219          "retail_rate": "9.80",
220          "retail_currency": "USD",
221          "list_rate": "8.25",
222          "list_currency": "USD",
223          "billing_type": "easypost",
224          "delivery_days": 2,
225          "delivery_date": null,
226          "delivery_date_guaranteed": false,
227          "est_delivery_days": 2,
228          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
229          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
230        },
231        {
232          "id": "rate_9be0bf0c869945d2b18a393a7cf5bc42",
233          "object": "Rate",
234          "created_at": "2024-06-13T22:05:03Z",
235          "updated_at": "2024-06-13T22:05:03Z",
236          "mode": "test",
237          "service": "GroundAdvantage",
238          "carrier": "USPS",
239          "rate": "5.07",
240          "currency": "USD",
241          "retail_rate": "6.70",
242          "retail_currency": "USD",
243          "list_rate": "5.07",
244          "list_currency": "USD",
245          "billing_type": "easypost",
246          "delivery_days": 3,
247          "delivery_date": null,
248          "delivery_date_guaranteed": false,
249          "est_delivery_days": 3,
250          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
251          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
252        },
253        {
254          "id": "rate_5d3e1c77fa264020a6a437dc4d9b5855",
255          "object": "Rate",
256          "created_at": "2024-06-13T22:05:03Z",
257          "updated_at": "2024-06-13T22:05:03Z",
258          "mode": "test",
259          "service": "First",
260          "carrier": "USPS",
261          "rate": "5.07",
262          "currency": "USD",
263          "retail_rate": "6.70",
264          "retail_currency": "USD",
265          "list_rate": "5.07",
266          "list_currency": "USD",
267          "billing_type": "easypost",
268          "delivery_days": 3,
269          "delivery_date": null,
270          "delivery_date_guaranteed": false,
271          "est_delivery_days": 3,
272          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
273          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
274        },
275        {
276          "id": "rate_49810a6defee4488a186fbdae9b0b21c",
277          "object": "Rate",
278          "created_at": "2024-06-13T22:05:03Z",
279          "updated_at": "2024-06-13T22:05:03Z",
280          "mode": "test",
281          "service": "ParcelSelect",
282          "carrier": "USPS",
283          "rate": "5.07",
284          "currency": "USD",
285          "retail_rate": "6.70",
286          "retail_currency": "USD",
287          "list_rate": "5.07",
288          "list_currency": "USD",
289          "billing_type": "easypost",
290          "delivery_days": 3,
291          "delivery_date": null,
292          "delivery_date_guaranteed": false,
293          "est_delivery_days": 3,
294          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
295          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
296        },
297        {
298          "id": "rate_3489ae08f18549d18b980f8960786a28",
299          "object": "Rate",
300          "created_at": "2024-06-13T22:05:03Z",
301          "updated_at": "2024-06-13T22:05:03Z",
302          "mode": "test",
303          "service": "Express",
304          "carrier": "USPS",
305          "rate": "33.10",
306          "currency": "USD",
307          "retail_rate": "37.90",
308          "retail_currency": "USD",
309          "list_rate": "33.10",
310          "list_currency": "USD",
311          "billing_type": "easypost",
312          "delivery_days": 1,
313          "delivery_date": null,
314          "delivery_date_guaranteed": false,
315          "est_delivery_days": 1,
316          "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
317          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
318        }
319      ],
320      "refund_status": null,
321      "scan_form": null,
322      "selected_rate": {
323        "id": "rate_5d3e1c77fa264020a6a437dc4d9b5855",
324        "object": "Rate",
325        "created_at": "2024-06-13T22:05:04Z",
326        "updated_at": "2024-06-13T22:05:04Z",
327        "mode": "test",
328        "service": "First",
329        "carrier": "USPS",
330        "rate": "5.07",
331        "currency": "USD",
332        "retail_rate": "6.70",
333        "retail_currency": "USD",
334        "list_rate": "5.07",
335        "list_currency": "USD",
336        "billing_type": "easypost",
337        "delivery_days": 3,
338        "delivery_date": null,
339        "delivery_date_guaranteed": false,
340        "est_delivery_days": 3,
341        "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
342        "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
343      },
344      "tracker": {
345        "id": "trk_873514a9423145efbff4d02a1359c430",
346        "object": "Tracker",
347        "mode": "test",
348        "tracking_code": "9400100110368051717318",
349        "status": "unknown",
350        "status_detail": "unknown",
351        "created_at": "2024-06-13T22:05:05Z",
352        "updated_at": "2024-06-13T22:05:05Z",
353        "signed_by": null,
354        "weight": null,
355        "est_delivery_date": null,
356        "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
357        "carrier": "USPS",
358        "tracking_details": [],
359        "fees": [],
360        "carrier_detail": null,
361        "public_url": "https://track.easypost.com/djE6dHJrXzg3MzUxNGE5NDIzMTQ1ZWZiZmY0ZDAyYTEzNTljNDMw"
362      },
363      "to_address": {
364        "id": "adr_fc2033fa29d011efb18c3cecef1b359e",
365        "object": "Address",
366        "created_at": "2024-06-13T22:05:03+00:00",
367        "updated_at": "2024-06-13T22:05:04+00:00",
368        "name": "DR. STEVE BRULE",
369        "company": null,
370        "street1": "179 N HARBOR DR",
371        "street2": "",
372        "city": "REDONDO BEACH",
373        "state": "CA",
374        "zip": "90277-2506",
375        "country": "US",
376        "phone": "8573875756",
377        "email": "DR_STEVE_BRULE@GMAIL.COM",
378        "mode": "test",
379        "carrier_facility": null,
380        "residential": false,
381        "federal_tax_id": null,
382        "state_tax_id": null,
383        "verifications": {
384          "zip4": {
385            "success": true,
386            "errors": [],
387            "details": null
388          },
389          "delivery": {
390            "success": true,
391            "errors": [],
392            "details": {
393              "latitude": 33.8436,
394              "longitude": -118.39177,
395              "time_zone": "America/Los_Angeles"
396            }
397          }
398        }
399      },
400      "usps_zone": 4,
401      "return_address": {
402        "id": "adr_fc21d34a29d011efb18e3cecef1b359e",
403        "object": "Address",
404        "created_at": "2024-06-13T22:05:03+00:00",
405        "updated_at": "2024-06-13T22:05:03+00:00",
406        "name": "EasyPost",
407        "company": null,
408        "street1": "417 Montgomery Street",
409        "street2": "5th Floor",
410        "city": "San Francisco",
411        "state": "CA",
412        "zip": "94104",
413        "country": "US",
414        "phone": "4153334445",
415        "email": "support@easypost.com",
416        "mode": "test",
417        "carrier_facility": null,
418        "residential": null,
419        "federal_tax_id": null,
420        "state_tax_id": null,
421        "verifications": {}
422      },
423      "buyer_address": {
424        "id": "adr_fc2033fa29d011efb18c3cecef1b359e",
425        "object": "Address",
426        "created_at": "2024-06-13T22:05:03+00:00",
427        "updated_at": "2024-06-13T22:05:04+00:00",
428        "name": "DR. STEVE BRULE",
429        "company": null,
430        "street1": "179 N HARBOR DR",
431        "street2": "",
432        "city": "REDONDO BEACH",
433        "state": "CA",
434        "zip": "90277-2506",
435        "country": "US",
436        "phone": "8573875756",
437        "email": "DR_STEVE_BRULE@GMAIL.COM",
438        "mode": "test",
439        "carrier_facility": null,
440        "residential": false,
441        "federal_tax_id": null,
442        "state_tax_id": null,
443        "verifications": {
444          "zip4": {
445            "success": true,
446            "errors": [],
447            "details": null
448          },
449          "delivery": {
450            "success": true,
451            "errors": [],
452            "details": {
453              "latitude": 33.8436,
454              "longitude": -118.39177,
455              "time_zone": "America/Los_Angeles"
456            }
457          }
458        }
459      },
460      "forms": [],
461      "fees": [
462        {
463          "object": "Fee",
464          "type": "LabelFee",
465          "amount": "0.00000",
466          "charged": true,
467          "refunded": false
468        },
469        {
470          "object": "Fee",
471          "type": "PostageFee",
472          "amount": "5.07000",
473          "charged": true,
474          "refunded": false
475        }
476      ],
477      "id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
478      "object": "Shipment"
479    },
480    {
481      "created_at": "2024-06-13T22:05:03Z",
482      "is_return": false,
483      "messages": [],
484      "mode": "test",
485      "options": {
486        "currency": "USD",
487        "payment": {
488          "type": "SENDER"
489        },
490        "date_advance": 0
491      },
492      "reference": null,
493      "status": "unknown",
494      "tracking_code": "9434600110368051717327",
495      "updated_at": "2024-06-13T22:05:04Z",
496      "batch_id": null,
497      "batch_status": null,
498      "batch_message": null,
499      "customs_info": null,
500      "from_address": {
501        "id": "adr_fc21d34a29d011efb18e3cecef1b359e",
502        "object": "Address",
503        "created_at": "2024-06-13T22:05:03+00:00",
504        "updated_at": "2024-06-13T22:05:03+00:00",
505        "name": "EasyPost",
506        "company": null,
507        "street1": "417 Montgomery Street",
508        "street2": "5th Floor",
509        "city": "San Francisco",
510        "state": "CA",
511        "zip": "94104",
512        "country": "US",
513        "phone": "4153334445",
514        "email": "support@easypost.com",
515        "mode": "test",
516        "carrier_facility": null,
517        "residential": null,
518        "federal_tax_id": null,
519        "state_tax_id": null,
520        "verifications": {}
521      },
522      "insurance": null,
523      "order_id": "order_508547ee50c84b7dbf3b18a8c730e319",
524      "parcel": {
525        "id": "prcl_fd5826adad704aa6bed4a374c2b3726c",
526        "object": "Parcel",
527        "created_at": "2024-06-13T22:05:03Z",
528        "updated_at": "2024-06-13T22:05:03Z",
529        "length": null,
530        "width": null,
531        "height": null,
532        "predefined_package": null,
533        "weight": 17.5,
534        "mode": "test"
535      },
536      "postage_label": {
537        "object": "PostageLabel",
538        "id": "pl_feb0e9c071fb47989acaead04158cdf1",
539        "created_at": "2024-06-13T22:05:04Z",
540        "updated_at": "2024-06-13T22:05:04Z",
541        "date_advance": 0,
542        "integrated_form": "none",
543        "label_date": "2024-06-13T22:05:04Z",
544        "label_resolution": 300,
545        "label_size": "4x6",
546        "label_type": "default",
547        "label_file_type": "image/png",
548        "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20240613/e858834ae57691479f9f0e4ebd0ae943b6.png",
549        "label_pdf_url": null,
550        "label_zpl_url": null,
551        "label_epl2_url": null,
552        "label_file": null
553      },
554      "rates": [
555        {
556          "id": "rate_0c3e55c07ccd47169b24a6e81cbddc2f",
557          "object": "Rate",
558          "created_at": "2024-06-13T22:05:03Z",
559          "updated_at": "2024-06-13T22:05:03Z",
560          "mode": "test",
561          "service": "GroundAdvantage",
562          "carrier": "USPS",
563          "rate": "6.26",
564          "currency": "USD",
565          "retail_rate": "10.80",
566          "retail_currency": "USD",
567          "list_rate": "7.75",
568          "list_currency": "USD",
569          "billing_type": "easypost",
570          "delivery_days": 3,
571          "delivery_date": null,
572          "delivery_date_guaranteed": false,
573          "est_delivery_days": 3,
574          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
575          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
576        },
577        {
578          "id": "rate_0b948416fe4a4d069cc520494c7e1403",
579          "object": "Rate",
580          "created_at": "2024-06-13T22:05:03Z",
581          "updated_at": "2024-06-13T22:05:03Z",
582          "mode": "test",
583          "service": "First",
584          "carrier": "USPS",
585          "rate": "6.26",
586          "currency": "USD",
587          "retail_rate": "10.80",
588          "retail_currency": "USD",
589          "list_rate": "7.75",
590          "list_currency": "USD",
591          "billing_type": "easypost",
592          "delivery_days": 3,
593          "delivery_date": null,
594          "delivery_date_guaranteed": false,
595          "est_delivery_days": 3,
596          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
597          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
598        },
599        {
600          "id": "rate_cc13e8bd6c88434baa68c8edb288ab63",
601          "object": "Rate",
602          "created_at": "2024-06-13T22:05:03Z",
603          "updated_at": "2024-06-13T22:05:03Z",
604          "mode": "test",
605          "service": "ParcelSelect",
606          "carrier": "USPS",
607          "rate": "6.26",
608          "currency": "USD",
609          "retail_rate": "10.80",
610          "retail_currency": "USD",
611          "list_rate": "7.75",
612          "list_currency": "USD",
613          "billing_type": "easypost",
614          "delivery_days": 3,
615          "delivery_date": null,
616          "delivery_date_guaranteed": false,
617          "est_delivery_days": 3,
618          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
619          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
620        },
621        {
622          "id": "rate_597402f87a2a484382414d0d55c923eb",
623          "object": "Rate",
624          "created_at": "2024-06-13T22:05:03Z",
625          "updated_at": "2024-06-13T22:05:03Z",
626          "mode": "test",
627          "service": "Express",
628          "carrier": "USPS",
629          "rate": "37.20",
630          "currency": "USD",
631          "retail_rate": "42.80",
632          "retail_currency": "USD",
633          "list_rate": "37.20",
634          "list_currency": "USD",
635          "billing_type": "easypost",
636          "delivery_days": 1,
637          "delivery_date": null,
638          "delivery_date_guaranteed": false,
639          "est_delivery_days": 1,
640          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
641          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
642        },
643        {
644          "id": "rate_c3a7609bb25d4c9ebd3967e1c03f0f1d",
645          "object": "Rate",
646          "created_at": "2024-06-13T22:05:03Z",
647          "updated_at": "2024-06-13T22:05:03Z",
648          "mode": "test",
649          "service": "Priority",
650          "carrier": "USPS",
651          "rate": "6.91",
652          "currency": "USD",
653          "retail_rate": "12.50",
654          "retail_currency": "USD",
655          "list_rate": "8.97",
656          "list_currency": "USD",
657          "billing_type": "easypost",
658          "delivery_days": 2,
659          "delivery_date": null,
660          "delivery_date_guaranteed": false,
661          "est_delivery_days": 2,
662          "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
663          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
664        }
665      ],
666      "refund_status": null,
667      "scan_form": null,
668      "selected_rate": {
669        "id": "rate_0b948416fe4a4d069cc520494c7e1403",
670        "object": "Rate",
671        "created_at": "2024-06-13T22:05:04Z",
672        "updated_at": "2024-06-13T22:05:04Z",
673        "mode": "test",
674        "service": "First",
675        "carrier": "USPS",
676        "rate": "6.26",
677        "currency": "USD",
678        "retail_rate": "10.80",
679        "retail_currency": "USD",
680        "list_rate": "7.75",
681        "list_currency": "USD",
682        "billing_type": "easypost",
683        "delivery_days": 3,
684        "delivery_date": null,
685        "delivery_date_guaranteed": false,
686        "est_delivery_days": 3,
687        "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
688        "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
689      },
690      "tracker": {
691        "id": "trk_efe0f8df84ae4ad89202ae51e70772b9",
692        "object": "Tracker",
693        "mode": "test",
694        "tracking_code": "9434600110368051717327",
695        "status": "unknown",
696        "status_detail": "unknown",
697        "created_at": "2024-06-13T22:05:05Z",
698        "updated_at": "2024-06-13T22:05:05Z",
699        "signed_by": null,
700        "weight": null,
701        "est_delivery_date": null,
702        "shipment_id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
703        "carrier": "USPS",
704        "tracking_details": [],
705        "fees": [],
706        "carrier_detail": null,
707        "public_url": "https://track.easypost.com/djE6dHJrX2VmZTBmOGRmODRhZTRhZDg5MjAyYWU1MWU3MDc3MmI5"
708      },
709      "to_address": {
710        "id": "adr_fc2033fa29d011efb18c3cecef1b359e",
711        "object": "Address",
712        "created_at": "2024-06-13T22:05:03+00:00",
713        "updated_at": "2024-06-13T22:05:04+00:00",
714        "name": "DR. STEVE BRULE",
715        "company": null,
716        "street1": "179 N HARBOR DR",
717        "street2": "",
718        "city": "REDONDO BEACH",
719        "state": "CA",
720        "zip": "90277-2506",
721        "country": "US",
722        "phone": "8573875756",
723        "email": "DR_STEVE_BRULE@GMAIL.COM",
724        "mode": "test",
725        "carrier_facility": null,
726        "residential": false,
727        "federal_tax_id": null,
728        "state_tax_id": null,
729        "verifications": {
730          "zip4": {
731            "success": true,
732            "errors": [],
733            "details": null
734          },
735          "delivery": {
736            "success": true,
737            "errors": [],
738            "details": {
739              "latitude": 33.8436,
740              "longitude": -118.39177,
741              "time_zone": "America/Los_Angeles"
742            }
743          }
744        }
745      },
746      "usps_zone": 4,
747      "return_address": {
748        "id": "adr_fc21d34a29d011efb18e3cecef1b359e",
749        "object": "Address",
750        "created_at": "2024-06-13T22:05:03+00:00",
751        "updated_at": "2024-06-13T22:05:03+00:00",
752        "name": "EasyPost",
753        "company": null,
754        "street1": "417 Montgomery Street",
755        "street2": "5th Floor",
756        "city": "San Francisco",
757        "state": "CA",
758        "zip": "94104",
759        "country": "US",
760        "phone": "4153334445",
761        "email": "support@easypost.com",
762        "mode": "test",
763        "carrier_facility": null,
764        "residential": null,
765        "federal_tax_id": null,
766        "state_tax_id": null,
767        "verifications": {}
768      },
769      "buyer_address": {
770        "id": "adr_fc2033fa29d011efb18c3cecef1b359e",
771        "object": "Address",
772        "created_at": "2024-06-13T22:05:03+00:00",
773        "updated_at": "2024-06-13T22:05:04+00:00",
774        "name": "DR. STEVE BRULE",
775        "company": null,
776        "street1": "179 N HARBOR DR",
777        "street2": "",
778        "city": "REDONDO BEACH",
779        "state": "CA",
780        "zip": "90277-2506",
781        "country": "US",
782        "phone": "8573875756",
783        "email": "DR_STEVE_BRULE@GMAIL.COM",
784        "mode": "test",
785        "carrier_facility": null,
786        "residential": false,
787        "federal_tax_id": null,
788        "state_tax_id": null,
789        "verifications": {
790          "zip4": {
791            "success": true,
792            "errors": [],
793            "details": null
794          },
795          "delivery": {
796            "success": true,
797            "errors": [],
798            "details": {
799              "latitude": 33.8436,
800              "longitude": -118.39177,
801              "time_zone": "America/Los_Angeles"
802            }
803          }
804        }
805      },
806      "forms": [],
807      "fees": [
808        {
809          "object": "Fee",
810          "type": "LabelFee",
811          "amount": "0.00000",
812          "charged": true,
813          "refunded": false
814        },
815        {
816          "object": "Fee",
817          "type": "PostageFee",
818          "amount": "6.26000",
819          "charged": true,
820          "refunded": false
821        }
822      ],
823      "id": "shp_6773f7d3d79f462999e8b32f6bb478ea",
824      "object": "Shipment"
825    }
826  ],
827  "rates": [
828    {
829      "id": "rate_05a312e263a3484997ef78113b40ca30",
830      "object": "Rate",
831      "created_at": null,
832      "updated_at": null,
833      "mode": "test",
834      "service": "Priority",
835      "carrier": "USPS",
836      "rate": "13.79",
837      "currency": "USD",
838      "retail_rate": "22.30",
839      "retail_currency": "USD",
840      "list_rate": "17.22",
841      "list_currency": "USD",
842      "billing_type": "easypost",
843      "delivery_days": 2,
844      "delivery_date": null,
845      "delivery_date_guaranteed": false,
846      "est_delivery_days": 2,
847      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
848      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
849    },
850    {
851      "id": "rate_9be0bf0c869945d2b18a393a7cf5bc42",
852      "object": "Rate",
853      "created_at": null,
854      "updated_at": null,
855      "mode": "test",
856      "service": "GroundAdvantage",
857      "carrier": "USPS",
858      "rate": "11.33",
859      "currency": "USD",
860      "retail_rate": "17.50",
861      "retail_currency": "USD",
862      "list_rate": "12.82",
863      "list_currency": "USD",
864      "billing_type": "easypost",
865      "delivery_days": 3,
866      "delivery_date": null,
867      "delivery_date_guaranteed": false,
868      "est_delivery_days": 3,
869      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
870      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
871    },
872    {
873      "id": "rate_5d3e1c77fa264020a6a437dc4d9b5855",
874      "object": "Rate",
875      "created_at": null,
876      "updated_at": null,
877      "mode": "test",
878      "service": "First",
879      "carrier": "USPS",
880      "rate": "11.33",
881      "currency": "USD",
882      "retail_rate": "17.50",
883      "retail_currency": "USD",
884      "list_rate": "12.82",
885      "list_currency": "USD",
886      "billing_type": "easypost",
887      "delivery_days": 3,
888      "delivery_date": null,
889      "delivery_date_guaranteed": false,
890      "est_delivery_days": 3,
891      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
892      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
893    },
894    {
895      "id": "rate_49810a6defee4488a186fbdae9b0b21c",
896      "object": "Rate",
897      "created_at": null,
898      "updated_at": null,
899      "mode": "test",
900      "service": "ParcelSelect",
901      "carrier": "USPS",
902      "rate": "11.33",
903      "currency": "USD",
904      "retail_rate": "17.50",
905      "retail_currency": "USD",
906      "list_rate": "12.82",
907      "list_currency": "USD",
908      "billing_type": "easypost",
909      "delivery_days": 3,
910      "delivery_date": null,
911      "delivery_date_guaranteed": false,
912      "est_delivery_days": 3,
913      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
914      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
915    },
916    {
917      "id": "rate_3489ae08f18549d18b980f8960786a28",
918      "object": "Rate",
919      "created_at": null,
920      "updated_at": null,
921      "mode": "test",
922      "service": "Express",
923      "carrier": "USPS",
924      "rate": "70.30",
925      "currency": "USD",
926      "retail_rate": "80.70",
927      "retail_currency": "USD",
928      "list_rate": "70.30",
929      "list_currency": "USD",
930      "billing_type": "easypost",
931      "delivery_days": 1,
932      "delivery_date": null,
933      "delivery_date_guaranteed": false,
934      "est_delivery_days": 1,
935      "shipment_id": "shp_494bf30aaa5e40fea8b34647cc8d451c",
936      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
937    }
938  ],
939  "id": "order_508547ee50c84b7dbf3b18a8c730e319",
940  "object": "Order"
941}

Buy an Order without rating (One-Call Buy)

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

reference
i.e. "my-reference"
to_address
i.e. Address
Can be specified by ID or attributes to create a new one, and be verified inline. See Create an Address
from_address
i.e. Address
Can be specified by ID or attributes to create a new one, and be verified inline. See Create an Address
shipments
i.e. Shipment array
A list of shipments
carrier_accounts
i.e. ["ca_..."]
List of carrier accounts
service
i.e. "Priority"
Service of carrier
POST /orders
1curl -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  }'
Response
1{
2  "messages": [],
3  "mode": "test",
4  "reference": "",
5  "is_return": false,
6  "options": {
7    "currency": "USD",
8    "payment": {
9      "type": "SENDER"
10    }
11  },
12  "created_at": "2024-06-13T22:05:05Z",
13  "updated_at": "2024-06-13T22:05:05Z",
14  "customs_info": null,
15  "from_address": {
16    "id": "adr_fd711ae529d011ef87e1ac1f6bc539ae",
17    "object": "Address",
18    "created_at": "2024-06-13T22:05:05+00:00",
19    "updated_at": "2024-06-13T22:05:05+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_fd6f173729d011ef97e1ac1f6bc539aa",
39    "object": "Address",
40    "created_at": "2024-06-13T22:05:05+00:00",
41    "updated_at": "2024-06-13T22:05:06+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_fd6f173729d011ef97e1ac1f6bc539aa",
76    "object": "Address",
77    "created_at": "2024-06-13T22:05:05+00:00",
78    "updated_at": "2024-06-13T22:05:06+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_fd711ae529d011ef87e1ac1f6bc539ae",
113    "object": "Address",
114    "created_at": "2024-06-13T22:05:05+00:00",
115    "updated_at": "2024-06-13T22:05:05+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      "created_at": "2024-06-13T22:05:05Z",
136      "is_return": false,
137      "messages": [],
138      "mode": "test",
139      "options": {
140        "currency": "USD",
141        "payment": {
142          "type": "SENDER"
143        },
144        "date_advance": 0
145      },
146      "reference": null,
147      "status": "unknown",
148      "tracking_code": "9400100110368051717332",
149      "updated_at": "2024-06-13T22:05:06Z",
150      "batch_id": null,
151      "batch_status": null,
152      "batch_message": null,
153      "customs_info": null,
154      "from_address": {
155        "id": "adr_fd711ae529d011ef87e1ac1f6bc539ae",
156        "object": "Address",
157        "created_at": "2024-06-13T22:05:05+00:00",
158        "updated_at": "2024-06-13T22:05:05+00:00",
159        "name": "EasyPost",
160        "company": null,
161        "street1": "417 Montgomery Street",
162        "street2": "5th Floor",
163        "city": "San Francisco",
164        "state": "CA",
165        "zip": "94104",
166        "country": "US",
167        "phone": "4153334445",
168        "email": "support@easypost.com",
169        "mode": "test",
170        "carrier_facility": null,
171        "residential": null,
172        "federal_tax_id": null,
173        "state_tax_id": null,
174        "verifications": {}
175      },
176      "insurance": null,
177      "order_id": "order_cee9d9ffe81c48e78df4a3ca7fff475a",
178      "parcel": {
179        "id": "prcl_6a92a7c56281409bbcb2c62ac8896f8c",
180        "object": "Parcel",
181        "created_at": "2024-06-13T22:05:05Z",
182        "updated_at": "2024-06-13T22:05:05Z",
183        "length": null,
184        "width": null,
185        "height": null,
186        "predefined_package": null,
187        "weight": 10.2,
188        "mode": "test"
189      },
190      "postage_label": {
191        "object": "PostageLabel",
192        "id": "pl_9d4b308e71c4440c83218e5b3355cc7d",
193        "created_at": "2024-06-13T22:05:06Z",
194        "updated_at": "2024-06-13T22:05:06Z",
195        "date_advance": 0,
196        "integrated_form": "none",
197        "label_date": "2024-06-13T22:05:06Z",
198        "label_resolution": 300,
199        "label_size": "4x6",
200        "label_type": "default",
201        "label_file_type": "image/png",
202        "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20240613/e8b6e7a94e086e46249b57f2c83267460d.png",
203        "label_pdf_url": null,
204        "label_zpl_url": null,
205        "label_epl2_url": null,
206        "label_file": null
207      },
208      "rates": [
209        {
210          "id": "rate_b137a81f4a954f518ad5ca3da6c6277f",
211          "object": "Rate",
212          "created_at": "2024-06-13T22:05:05Z",
213          "updated_at": "2024-06-13T22:05:05Z",
214          "mode": "test",
215          "service": "Priority",
216          "carrier": "USPS",
217          "rate": "6.88",
218          "currency": "USD",
219          "retail_rate": "9.80",
220          "retail_currency": "USD",
221          "list_rate": "8.25",
222          "list_currency": "USD",
223          "billing_type": "easypost",
224          "delivery_days": 2,
225          "delivery_date": null,
226          "delivery_date_guaranteed": false,
227          "est_delivery_days": 2,
228          "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
229          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
230        },
231        {
232          "id": "rate_f9de392f3c4a4bb2b4bef51e2b7a565d",
233          "object": "Rate",
234          "created_at": "2024-06-13T22:05:05Z",
235          "updated_at": "2024-06-13T22:05:05Z",
236          "mode": "test",
237          "service": "GroundAdvantage",
238          "carrier": "USPS",
239          "rate": "5.07",
240          "currency": "USD",
241          "retail_rate": "6.70",
242          "retail_currency": "USD",
243          "list_rate": "5.07",
244          "list_currency": "USD",
245          "billing_type": "easypost",
246          "delivery_days": 3,
247          "delivery_date": null,
248          "delivery_date_guaranteed": false,
249          "est_delivery_days": 3,
250          "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
251          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
252        },
253        {
254          "id": "rate_ed64f8b52c6e488cbd6f2bb5dd555852",
255          "object": "Rate",
256          "created_at": "2024-06-13T22:05:05Z",
257          "updated_at": "2024-06-13T22:05:05Z",
258          "mode": "test",
259          "service": "First",
260          "carrier": "USPS",
261          "rate": "5.07",
262          "currency": "USD",
263          "retail_rate": "6.70",
264          "retail_currency": "USD",
265          "list_rate": "5.07",
266          "list_currency": "USD",
267          "billing_type": "easypost",
268          "delivery_days": 3,
269          "delivery_date": null,
270          "delivery_date_guaranteed": false,
271          "est_delivery_days": 3,
272          "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
273          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
274        },
275        {
276          "id": "rate_c0a8e97ac71d40109f91aadc18af3521",
277          "object": "Rate",
278          "created_at": "2024-06-13T22:05:05Z",
279          "updated_at": "2024-06-13T22:05:05Z",
280          "mode": "test",
281          "service": "ParcelSelect",
282          "carrier": "USPS",
283          "rate": "5.07",
284          "currency": "USD",
285          "retail_rate": "6.70",
286          "retail_currency": "USD",
287          "list_rate": "5.07",
288          "list_currency": "USD",
289          "billing_type": "easypost",
290          "delivery_days": 3,
291          "delivery_date": null,
292          "delivery_date_guaranteed": false,
293          "est_delivery_days": 3,
294          "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
295          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
296        },
297        {
298          "id": "rate_a25e227ebdfc4fa2adb9a2e2a5a2460d",
299          "object": "Rate",
300          "created_at": "2024-06-13T22:05:05Z",
301          "updated_at": "2024-06-13T22:05:05Z",
302          "mode": "test",
303          "service": "Express",
304          "carrier": "USPS",
305          "rate": "33.10",
306          "currency": "USD",
307          "retail_rate": "37.90",
308          "retail_currency": "USD",
309          "list_rate": "33.10",
310          "list_currency": "USD",
311          "billing_type": "easypost",
312          "delivery_days": 1,
313          "delivery_date": null,
314          "delivery_date_guaranteed": false,
315          "est_delivery_days": 1,
316          "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
317          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
318        }
319      ],
320      "refund_status": null,
321      "scan_form": null,
322      "selected_rate": {
323        "id": "rate_ed64f8b52c6e488cbd6f2bb5dd555852",
324        "object": "Rate",
325        "created_at": "2024-06-13T22:05:06Z",
326        "updated_at": "2024-06-13T22:05:06Z",
327        "mode": "test",
328        "service": "First",
329        "carrier": "USPS",
330        "rate": "5.07",
331        "currency": "USD",
332        "retail_rate": "6.70",
333        "retail_currency": "USD",
334        "list_rate": "5.07",
335        "list_currency": "USD",
336        "billing_type": "easypost",
337        "delivery_days": 3,
338        "delivery_date": null,
339        "delivery_date_guaranteed": false,
340        "est_delivery_days": 3,
341        "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
342        "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
343      },
344      "tracker": {
345        "id": "trk_ca73cd7c017f437d94450215ef35c6a2",
346        "object": "Tracker",
347        "mode": "test",
348        "tracking_code": "9400100110368051717332",
349        "status": "unknown",
350        "status_detail": "unknown",
351        "created_at": "2024-06-13T22:05:07Z",
352        "updated_at": "2024-06-13T22:05:07Z",
353        "signed_by": null,
354        "weight": null,
355        "est_delivery_date": null,
356        "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
357        "carrier": "USPS",
358        "tracking_details": [],
359        "fees": [],
360        "carrier_detail": null,
361        "public_url": "https://track.easypost.com/djE6dHJrX2NhNzNjZDdjMDE3ZjQzN2Q5NDQ1MDIxNWVmMzVjNmEy"
362      },
363      "to_address": {
364        "id": "adr_fd6f173729d011ef97e1ac1f6bc539aa",
365        "object": "Address",
366        "created_at": "2024-06-13T22:05:05+00:00",
367        "updated_at": "2024-06-13T22:05:06+00:00",
368        "name": "DR. STEVE BRULE",
369        "company": null,
370        "street1": "179 N HARBOR DR",
371        "street2": "",
372        "city": "REDONDO BEACH",
373        "state": "CA",
374        "zip": "90277-2506",
375        "country": "US",
376        "phone": "8573875756",
377        "email": "DR_STEVE_BRULE@GMAIL.COM",
378        "mode": "test",
379        "carrier_facility": null,
380        "residential": false,
381        "federal_tax_id": null,
382        "state_tax_id": null,
383        "verifications": {
384          "zip4": {
385            "success": true,
386            "errors": [],
387            "details": null
388          },
389          "delivery": {
390            "success": true,
391            "errors": [],
392            "details": {
393              "latitude": 33.8436,
394              "longitude": -118.39177,
395              "time_zone": "America/Los_Angeles"
396            }
397          }
398        }
399      },
400      "usps_zone": 4,
401      "return_address": {
402        "id": "adr_fd711ae529d011ef87e1ac1f6bc539ae",
403        "object": "Address",
404        "created_at": "2024-06-13T22:05:05+00:00",
405        "updated_at": "2024-06-13T22:05:05+00:00",
406        "name": "EasyPost",
407        "company": null,
408        "street1": "417 Montgomery Street",
409        "street2": "5th Floor",
410        "city": "San Francisco",
411        "state": "CA",
412        "zip": "94104",
413        "country": "US",
414        "phone": "4153334445",
415        "email": "support@easypost.com",
416        "mode": "test",
417        "carrier_facility": null,
418        "residential": null,
419        "federal_tax_id": null,
420        "state_tax_id": null,
421        "verifications": {}
422      },
423      "buyer_address": {
424        "id": "adr_fd6f173729d011ef97e1ac1f6bc539aa",
425        "object": "Address",
426        "created_at": "2024-06-13T22:05:05+00:00",
427        "updated_at": "2024-06-13T22:05:06+00:00",
428        "name": "DR. STEVE BRULE",
429        "company": null,
430        "street1": "179 N HARBOR DR",
431        "street2": "",
432        "city": "REDONDO BEACH",
433        "state": "CA",
434        "zip": "90277-2506",
435        "country": "US",
436        "phone": "8573875756",
437        "email": "DR_STEVE_BRULE@GMAIL.COM",
438        "mode": "test",
439        "carrier_facility": null,
440        "residential": false,
441        "federal_tax_id": null,
442        "state_tax_id": null,
443        "verifications": {
444          "zip4": {
445            "success": true,
446            "errors": [],
447            "details": null
448          },
449          "delivery": {
450            "success": true,
451            "errors": [],
452            "details": {
453              "latitude": 33.8436,
454              "longitude": -118.39177,
455              "time_zone": "America/Los_Angeles"
456            }
457          }
458        }
459      },
460      "forms": [],
461      "fees": [
462        {
463          "object": "Fee",
464          "type": "LabelFee",
465          "amount": "0.00000",
466          "charged": true,
467          "refunded": false
468        },
469        {
470          "object": "Fee",
471          "type": "PostageFee",
472          "amount": "5.07000",
473          "charged": true,
474          "refunded": false
475        }
476      ],
477      "id": "shp_807ca6fd99554549bfd47a052fbaa60d",
478      "object": "Shipment"
479    },
480    {
481      "created_at": "2024-06-13T22:05:05Z",
482      "is_return": false,
483      "messages": [],
484      "mode": "test",
485      "options": {
486        "currency": "USD",
487        "payment": {
488          "type": "SENDER"
489        },
490        "date_advance": 0
491      },
492      "reference": null,
493      "status": "unknown",
494      "tracking_code": "9434600110368051717341",
495      "updated_at": "2024-06-13T22:05:07Z",
496      "batch_id": null,
497      "batch_status": null,
498      "batch_message": null,
499      "customs_info": null,
500      "from_address": {
501        "id": "adr_fd711ae529d011ef87e1ac1f6bc539ae",
502        "object": "Address",
503        "created_at": "2024-06-13T22:05:05+00:00",
504        "updated_at": "2024-06-13T22:05:05+00:00",
505        "name": "EasyPost",
506        "company": null,
507        "street1": "417 Montgomery Street",
508        "street2": "5th Floor",
509        "city": "San Francisco",
510        "state": "CA",
511        "zip": "94104",
512        "country": "US",
513        "phone": "4153334445",
514        "email": "support@easypost.com",
515        "mode": "test",
516        "carrier_facility": null,
517        "residential": null,
518        "federal_tax_id": null,
519        "state_tax_id": null,
520        "verifications": {}
521      },
522      "insurance": null,
523      "order_id": "order_cee9d9ffe81c48e78df4a3ca7fff475a",
524      "parcel": {
525        "id": "prcl_1fec56736e344110a29480715c6c85ef",
526        "object": "Parcel",
527        "created_at": "2024-06-13T22:05:05Z",
528        "updated_at": "2024-06-13T22:05:05Z",
529        "length": null,
530        "width": null,
531        "height": null,
532        "predefined_package": null,
533        "weight": 17.5,
534        "mode": "test"
535      },
536      "postage_label": {
537        "object": "PostageLabel",
538        "id": "pl_96f98442c6624209aa826b13810d0d5e",
539        "created_at": "2024-06-13T22:05:07Z",
540        "updated_at": "2024-06-13T22:05:07Z",
541        "date_advance": 0,
542        "integrated_form": "none",
543        "label_date": "2024-06-13T22:05:07Z",
544        "label_resolution": 300,
545        "label_size": "4x6",
546        "label_type": "default",
547        "label_file_type": "image/png",
548        "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20240613/e8e76bff1675af445fb02ed17df8950200.png",
549        "label_pdf_url": null,
550        "label_zpl_url": null,
551        "label_epl2_url": null,
552        "label_file": null
553      },
554      "rates": [
555        {
556          "id": "rate_09685a2c90464d0fa0f7526a64ac897c",
557          "object": "Rate",
558          "created_at": "2024-06-13T22:05:05Z",
559          "updated_at": "2024-06-13T22:05:05Z",
560          "mode": "test",
561          "service": "Express",
562          "carrier": "USPS",
563          "rate": "37.20",
564          "currency": "USD",
565          "retail_rate": "42.80",
566          "retail_currency": "USD",
567          "list_rate": "37.20",
568          "list_currency": "USD",
569          "billing_type": "easypost",
570          "delivery_days": 1,
571          "delivery_date": null,
572          "delivery_date_guaranteed": false,
573          "est_delivery_days": 1,
574          "shipment_id": "shp_9d3dea6c4d744b3587310f516f6ac91b",
575          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
576        },
577        {
578          "id": "rate_eb2e64be35b14b43822b283376a7fc37",
579          "object": "Rate",
580          "created_at": "2024-06-13T22:05:05Z",
581          "updated_at": "2024-06-13T22:05:05Z",
582          "mode": "test",
583          "service": "Priority",
584          "carrier": "USPS",
585          "rate": "6.91",
586          "currency": "USD",
587          "retail_rate": "12.50",
588          "retail_currency": "USD",
589          "list_rate": "8.97",
590          "list_currency": "USD",
591          "billing_type": "easypost",
592          "delivery_days": 2,
593          "delivery_date": null,
594          "delivery_date_guaranteed": false,
595          "est_delivery_days": 2,
596          "shipment_id": "shp_9d3dea6c4d744b3587310f516f6ac91b",
597          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
598        },
599        {
600          "id": "rate_16592d73a81346a685e3aedee7c0ca07",
601          "object": "Rate",
602          "created_at": "2024-06-13T22:05:05Z",
603          "updated_at": "2024-06-13T22:05:05Z",
604          "mode": "test",
605          "service": "GroundAdvantage",
606          "carrier": "USPS",
607          "rate": "6.26",
608          "currency": "USD",
609          "retail_rate": "10.80",
610          "retail_currency": "USD",
611          "list_rate": "7.75",
612          "list_currency": "USD",
613          "billing_type": "easypost",
614          "delivery_days": 3,
615          "delivery_date": null,
616          "delivery_date_guaranteed": false,
617          "est_delivery_days": 3,
618          "shipment_id": "shp_9d3dea6c4d744b3587310f516f6ac91b",
619          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
620        },
621        {
622          "id": "rate_69dd4a338c234461a3b5f7a3981919fb",
623          "object": "Rate",
624          "created_at": "2024-06-13T22:05:05Z",
625          "updated_at": "2024-06-13T22:05:05Z",
626          "mode": "test",
627          "service": "First",
628          "carrier": "USPS",
629          "rate": "6.26",
630          "currency": "USD",
631          "retail_rate": "10.80",
632          "retail_currency": "USD",
633          "list_rate": "7.75",
634          "list_currency": "USD",
635          "billing_type": "easypost",
636          "delivery_days": 3,
637          "delivery_date": null,
638          "delivery_date_guaranteed": false,
639          "est_delivery_days": 3,
640          "shipment_id": "shp_9d3dea6c4d744b3587310f516f6ac91b",
641          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
642        },
643        {
644          "id": "rate_ac2db535d9f3469b953ec2e7532f0a11",
645          "object": "Rate",
646          "created_at": "2024-06-13T22:05:05Z",
647          "updated_at": "2024-06-13T22:05:05Z",
648          "mode": "test",
649          "service": "ParcelSelect",
650          "carrier": "USPS",
651          "rate": "6.26",
652          "currency": "USD",
653          "retail_rate": "10.80",
654          "retail_currency": "USD",
655          "list_rate": "7.75",
656          "list_currency": "USD",
657          "billing_type": "easypost",
658          "delivery_days": 3,
659          "delivery_date": null,
660          "delivery_date_guaranteed": false,
661          "est_delivery_days": 3,
662          "shipment_id": "shp_9d3dea6c4d744b3587310f516f6ac91b",
663          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
664        }
665      ],
666      "refund_status": null,
667      "scan_form": null,
668      "selected_rate": {
669        "id": "rate_69dd4a338c234461a3b5f7a3981919fb",
670        "object": "Rate",
671        "created_at": "2024-06-13T22:05:07Z",
672        "updated_at": "2024-06-13T22:05:07Z",
673        "mode": "test",
674        "service": "First",
675        "carrier": "USPS",
676        "rate": "6.26",
677        "currency": "USD",
678        "retail_rate": "10.80",
679        "retail_currency": "USD",
680        "list_rate": "7.75",
681        "list_currency": "USD",
682        "billing_type": "easypost",
683        "delivery_days": 3,
684        "delivery_date": null,
685        "delivery_date_guaranteed": false,
686        "est_delivery_days": 3,
687        "shipment_id": "shp_9d3dea6c4d744b3587310f516f6ac91b",
688        "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
689      },
690      "tracker": {
691        "id": "trk_01654fc4d2e34d1f94488e788c2cf12b",
692        "object": "Tracker",
693        "mode": "test",
694        "tracking_code": "9434600110368051717341",
695        "status": "unknown",
696        "status_detail": "unknown",
697        "created_at": "2024-06-13T22:05:07Z",
698        "updated_at": "2024-06-13T22:05:07Z",
699        "signed_by": null,
700        "weight": null,
701        "est_delivery_date": null,
702        "shipment_id": "shp_9d3dea6c4d744b3587310f516f6ac91b",
703        "carrier": "USPS",
704        "tracking_details": [],
705        "fees": [],
706        "carrier_detail": null,
707        "public_url": "https://track.easypost.com/djE6dHJrXzAxNjU0ZmM0ZDJlMzRkMWY5NDQ4OGU3ODhjMmNmMTJi"
708      },
709      "to_address": {
710        "id": "adr_fd6f173729d011ef97e1ac1f6bc539aa",
711        "object": "Address",
712        "created_at": "2024-06-13T22:05:05+00:00",
713        "updated_at": "2024-06-13T22:05:06+00:00",
714        "name": "DR. STEVE BRULE",
715        "company": null,
716        "street1": "179 N HARBOR DR",
717        "street2": "",
718        "city": "REDONDO BEACH",
719        "state": "CA",
720        "zip": "90277-2506",
721        "country": "US",
722        "phone": "8573875756",
723        "email": "DR_STEVE_BRULE@GMAIL.COM",
724        "mode": "test",
725        "carrier_facility": null,
726        "residential": false,
727        "federal_tax_id": null,
728        "state_tax_id": null,
729        "verifications": {
730          "zip4": {
731            "success": true,
732            "errors": [],
733            "details": null
734          },
735          "delivery": {
736            "success": true,
737            "errors": [],
738            "details": {
739              "latitude": 33.8436,
740              "longitude": -118.39177,
741              "time_zone": "America/Los_Angeles"
742            }
743          }
744        }
745      },
746      "usps_zone": 4,
747      "return_address": {
748        "id": "adr_fd711ae529d011ef87e1ac1f6bc539ae",
749        "object": "Address",
750        "created_at": "2024-06-13T22:05:05+00:00",
751        "updated_at": "2024-06-13T22:05:05+00:00",
752        "name": "EasyPost",
753        "company": null,
754        "street1": "417 Montgomery Street",
755        "street2": "5th Floor",
756        "city": "San Francisco",
757        "state": "CA",
758        "zip": "94104",
759        "country": "US",
760        "phone": "4153334445",
761        "email": "support@easypost.com",
762        "mode": "test",
763        "carrier_facility": null,
764        "residential": null,
765        "federal_tax_id": null,
766        "state_tax_id": null,
767        "verifications": {}
768      },
769      "buyer_address": {
770        "id": "adr_fd6f173729d011ef97e1ac1f6bc539aa",
771        "object": "Address",
772        "created_at": "2024-06-13T22:05:05+00:00",
773        "updated_at": "2024-06-13T22:05:06+00:00",
774        "name": "DR. STEVE BRULE",
775        "company": null,
776        "street1": "179 N HARBOR DR",
777        "street2": "",
778        "city": "REDONDO BEACH",
779        "state": "CA",
780        "zip": "90277-2506",
781        "country": "US",
782        "phone": "8573875756",
783        "email": "DR_STEVE_BRULE@GMAIL.COM",
784        "mode": "test",
785        "carrier_facility": null,
786        "residential": false,
787        "federal_tax_id": null,
788        "state_tax_id": null,
789        "verifications": {
790          "zip4": {
791            "success": true,
792            "errors": [],
793            "details": null
794          },
795          "delivery": {
796            "success": true,
797            "errors": [],
798            "details": {
799              "latitude": 33.8436,
800              "longitude": -118.39177,
801              "time_zone": "America/Los_Angeles"
802            }
803          }
804        }
805      },
806      "forms": [],
807      "fees": [
808        {
809          "object": "Fee",
810          "type": "LabelFee",
811          "amount": "0.00000",
812          "charged": true,
813          "refunded": false
814        },
815        {
816          "object": "Fee",
817          "type": "PostageFee",
818          "amount": "6.26000",
819          "charged": true,
820          "refunded": false
821        }
822      ],
823      "id": "shp_9d3dea6c4d744b3587310f516f6ac91b",
824      "object": "Shipment"
825    }
826  ],
827  "rates": [
828    {
829      "id": "rate_b137a81f4a954f518ad5ca3da6c6277f",
830      "object": "Rate",
831      "created_at": null,
832      "updated_at": null,
833      "mode": "test",
834      "service": "Priority",
835      "carrier": "USPS",
836      "rate": "13.79",
837      "currency": "USD",
838      "retail_rate": "22.30",
839      "retail_currency": "USD",
840      "list_rate": "17.22",
841      "list_currency": "USD",
842      "billing_type": "easypost",
843      "delivery_days": 2,
844      "delivery_date": null,
845      "delivery_date_guaranteed": false,
846      "est_delivery_days": 2,
847      "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
848      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
849    },
850    {
851      "id": "rate_f9de392f3c4a4bb2b4bef51e2b7a565d",
852      "object": "Rate",
853      "created_at": null,
854      "updated_at": null,
855      "mode": "test",
856      "service": "GroundAdvantage",
857      "carrier": "USPS",
858      "rate": "11.33",
859      "currency": "USD",
860      "retail_rate": "17.50",
861      "retail_currency": "USD",
862      "list_rate": "12.82",
863      "list_currency": "USD",
864      "billing_type": "easypost",
865      "delivery_days": 3,
866      "delivery_date": null,
867      "delivery_date_guaranteed": false,
868      "est_delivery_days": 3,
869      "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
870      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
871    },
872    {
873      "id": "rate_ed64f8b52c6e488cbd6f2bb5dd555852",
874      "object": "Rate",
875      "created_at": null,
876      "updated_at": null,
877      "mode": "test",
878      "service": "First",
879      "carrier": "USPS",
880      "rate": "11.33",
881      "currency": "USD",
882      "retail_rate": "17.50",
883      "retail_currency": "USD",
884      "list_rate": "12.82",
885      "list_currency": "USD",
886      "billing_type": "easypost",
887      "delivery_days": 3,
888      "delivery_date": null,
889      "delivery_date_guaranteed": false,
890      "est_delivery_days": 3,
891      "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
892      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
893    },
894    {
895      "id": "rate_c0a8e97ac71d40109f91aadc18af3521",
896      "object": "Rate",
897      "created_at": null,
898      "updated_at": null,
899      "mode": "test",
900      "service": "ParcelSelect",
901      "carrier": "USPS",
902      "rate": "11.33",
903      "currency": "USD",
904      "retail_rate": "17.50",
905      "retail_currency": "USD",
906      "list_rate": "12.82",
907      "list_currency": "USD",
908      "billing_type": "easypost",
909      "delivery_days": 3,
910      "delivery_date": null,
911      "delivery_date_guaranteed": false,
912      "est_delivery_days": 3,
913      "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
914      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
915    },
916    {
917      "id": "rate_a25e227ebdfc4fa2adb9a2e2a5a2460d",
918      "object": "Rate",
919      "created_at": null,
920      "updated_at": null,
921      "mode": "test",
922      "service": "Express",
923      "carrier": "USPS",
924      "rate": "70.30",
925      "currency": "USD",
926      "retail_rate": "80.70",
927      "retail_currency": "USD",
928      "list_rate": "70.30",
929      "list_currency": "USD",
930      "billing_type": "easypost",
931      "delivery_days": 1,
932      "delivery_date": null,
933      "delivery_date_guaranteed": false,
934      "est_delivery_days": 1,
935      "shipment_id": "shp_807ca6fd99554549bfd47a052fbaa60d",
936      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
937    }
938  ],
939  "id": "order_cee9d9ffe81c48e78df4a3ca7fff475a",
940  "object": "Order"
941}

Retrieve an Order

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.

GET /orders/:id
1curl -X GET https://api.easypost.com/v2/orders/order_... \
2  -u "EASYPOST_API_KEY":
Response
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": "2024-01-24T00:05:55Z",
13  "updated_at": "2024-01-24T00:05:55Z",
14  "customs_info": null,
15  "from_address": {
16    "id": "adr_5836298bba4c11eebaecac1f6bc53342",
17    "object": "Address",
18    "created_at": "2024-01-24T00:05:55+00:00",
19    "updated_at": "2024-01-24T00:05:55+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_583448c1ba4c11eebaebac1f6bc53342",
39    "object": "Address",
40    "created_at": "2024-01-24T00:05:55+00:00",
41    "updated_at": "2024-01-24T00:05:55+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_583448c1ba4c11eebaebac1f6bc53342",
61    "object": "Address",
62    "created_at": "2024-01-24T00:05:55+00:00",
63    "updated_at": "2024-01-24T00:05:55+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_5836298bba4c11eebaecac1f6bc53342",
83    "object": "Address",
84    "created_at": "2024-01-24T00:05:55+00:00",
85    "updated_at": "2024-01-24T00:05:55+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      "created_at": "2024-01-24T00:05:55Z",
106      "is_return": false,
107      "messages": [],
108      "mode": "test",
109      "options": {
110        "currency": "USD",
111        "payment": {
112          "type": "SENDER"
113        },
114        "date_advance": 0
115      },
116      "reference": null,
117      "status": "unknown",
118      "tracking_code": null,
119      "updated_at": "2024-01-24T00:05:55Z",
120      "batch_id": null,
121      "batch_status": null,
122      "batch_message": null,
123      "customs_info": null,
124      "from_address": {
125        "id": "adr_5836298bba4c11eebaecac1f6bc53342",
126        "object": "Address",
127        "created_at": "2024-01-24T00:05:55+00:00",
128        "updated_at": "2024-01-24T00:05:55+00:00",
129        "name": "EasyPost",
130        "company": null,
131        "street1": "417 Montgomery Street",
132        "street2": "5th Floor",
133        "city": "San Francisco",
134        "state": "CA",
135        "zip": "94104",
136        "country": "US",
137        "phone": "4153334445",
138        "email": "support@easypost.com",
139        "mode": "test",
140        "carrier_facility": null,
141        "residential": null,
142        "federal_tax_id": null,
143        "state_tax_id": null,
144        "verifications": {}
145      },
146      "insurance": null,
147      "order_id": "order_b567c8fffd5641608bda48f0bc58e1d6",
148      "parcel": {
149        "id": "prcl_eb7de3870d864d408017e4e5a8633b1a",
150        "object": "Parcel",
151        "created_at": "2024-01-24T00:05:55Z",
152        "updated_at": "2024-01-24T00:05:55Z",
153        "length": null,
154        "width": null,
155        "height": null,
156        "predefined_package": null,
157        "weight": 10.2,
158        "mode": "test"
159      },
160      "postage_label": null,
161      "rates": [
162        {
163          "id": "rate_46c2da4561664d5fbc7ebfca38e472d6",
164          "object": "Rate",
165          "created_at": "2024-01-24T00:05:55Z",
166          "updated_at": "2024-01-24T00:05:55Z",
167          "mode": "test",
168          "service": "Express",
169          "carrier": "USPS",
170          "rate": "33.10",
171          "currency": "USD",
172          "retail_rate": "37.90",
173          "retail_currency": "USD",
174          "list_rate": "33.10",
175          "list_currency": "USD",
176          "billing_type": "easypost",
177          "delivery_days": null,
178          "delivery_date": null,
179          "delivery_date_guaranteed": false,
180          "est_delivery_days": null,
181          "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
182          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
183        },
184        {
185          "id": "rate_5f8a285fa1094e129d121e4dfe59c314",
186          "object": "Rate",
187          "created_at": "2024-01-24T00:05:55Z",
188          "updated_at": "2024-01-24T00:05:55Z",
189          "mode": "test",
190          "service": "Priority",
191          "carrier": "USPS",
192          "rate": "6.88",
193          "currency": "USD",
194          "retail_rate": "9.80",
195          "retail_currency": "USD",
196          "list_rate": "8.25",
197          "list_currency": "USD",
198          "billing_type": "easypost",
199          "delivery_days": 2,
200          "delivery_date": null,
201          "delivery_date_guaranteed": false,
202          "est_delivery_days": 2,
203          "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
204          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
205        },
206        {
207          "id": "rate_836fd4e6359e4e40bc27bc39eff5b432",
208          "object": "Rate",
209          "created_at": "2024-01-24T00:05:55Z",
210          "updated_at": "2024-01-24T00:05:55Z",
211          "mode": "test",
212          "service": "GroundAdvantage",
213          "carrier": "USPS",
214          "rate": "5.07",
215          "currency": "USD",
216          "retail_rate": "6.70",
217          "retail_currency": "USD",
218          "list_rate": "5.07",
219          "list_currency": "USD",
220          "billing_type": "easypost",
221          "delivery_days": 3,
222          "delivery_date": null,
223          "delivery_date_guaranteed": false,
224          "est_delivery_days": 3,
225          "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
226          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
227        },
228        {
229          "id": "rate_d1fe066dc3c844c2984ac13308bf7b3e",
230          "object": "Rate",
231          "created_at": "2024-01-24T00:05:55Z",
232          "updated_at": "2024-01-24T00:05:55Z",
233          "mode": "test",
234          "service": "First",
235          "carrier": "USPS",
236          "rate": "5.07",
237          "currency": "USD",
238          "retail_rate": "6.70",
239          "retail_currency": "USD",
240          "list_rate": "5.07",
241          "list_currency": "USD",
242          "billing_type": "easypost",
243          "delivery_days": 3,
244          "delivery_date": null,
245          "delivery_date_guaranteed": false,
246          "est_delivery_days": 3,
247          "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
248          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
249        },
250        {
251          "id": "rate_3b915871b5ff4cccaec973eedde9e4bb",
252          "object": "Rate",
253          "created_at": "2024-01-24T00:05:55Z",
254          "updated_at": "2024-01-24T00:05:55Z",
255          "mode": "test",
256          "service": "ParcelSelect",
257          "carrier": "USPS",
258          "rate": "5.07",
259          "currency": "USD",
260          "retail_rate": "6.70",
261          "retail_currency": "USD",
262          "list_rate": "5.07",
263          "list_currency": "USD",
264          "billing_type": "easypost",
265          "delivery_days": 3,
266          "delivery_date": null,
267          "delivery_date_guaranteed": false,
268          "est_delivery_days": 3,
269          "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
270          "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
271        }
272      ],
273      "refund_status": null,
274      "scan_form": null,
275      "selected_rate": null,
276      "tracker": null,
277      "to_address": {
278        "id": "adr_583448c1ba4c11eebaebac1f6bc53342",
279        "object": "Address",
280        "created_at": "2024-01-24T00:05:55+00:00",
281        "updated_at": "2024-01-24T00:05:55+00:00",
282        "name": "Dr. Steve Brule",
283        "company": null,
284        "street1": "179 N Harbor Dr",
285        "street2": null,
286        "city": "Redondo Beach",
287        "state": "CA",
288        "zip": "90277",
289        "country": "US",
290        "phone": "8573875756",
291        "email": "dr_steve_brule@gmail.com",
292        "mode": "test",
293        "carrier_facility": null,
294        "residential": null,
295        "federal_tax_id": null,
296        "state_tax_id": null,
297        "verifications": {}
298      },
299      "usps_zone": 4,
300      "return_address": {
301        "id": "adr_5836298bba4c11eebaecac1f6bc53342",
302        "object": "Address",
303        "created_at": "2024-01-24T00:05:55+00:00",
304        "updated_at": "2024-01-24T00:05:55+00:00",
305        "name": "EasyPost",
306        "company": null,
307        "street1": "417 Montgomery Street",
308        "street2": "5th Floor",
309        "city": "San Francisco",
310        "state": "CA",
311        "zip": "94104",
312        "country": "US",
313        "phone": "4153334445",
314        "email": "support@easypost.com",
315        "mode": "test",
316        "carrier_facility": null,
317        "residential": null,
318        "federal_tax_id": null,
319        "state_tax_id": null,
320        "verifications": {}
321      },
322      "buyer_address": {
323        "id": "adr_583448c1ba4c11eebaebac1f6bc53342",
324        "object": "Address",
325        "created_at": "2024-01-24T00:05:55+00:00",
326        "updated_at": "2024-01-24T00:05:55+00:00",
327        "name": "Dr. Steve Brule",
328        "company": null,
329        "street1": "179 N Harbor Dr",
330        "street2": null,
331        "city": "Redondo Beach",
332        "state": "CA",
333        "zip": "90277",
334        "country": "US",
335        "phone": "8573875756",
336        "email": "dr_steve_brule@gmail.com",
337        "mode": "test",
338        "carrier_facility": null,
339        "residential": null,
340        "federal_tax_id": null,
341        "state_tax_id": null,
342        "verifications": {}
343      },
344      "forms": [],
345      "fees": [],
346      "id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
347      "object": "Shipment"
348    }
349  ],
350  "rates": [
351    {
352      "id": "rate_46c2da4561664d5fbc7ebfca38e472d6",
353      "object": "Rate",
354      "created_at": null,
355      "updated_at": null,
356      "mode": "test",
357      "service": "Express",
358      "carrier": "USPS",
359      "rate": "33.10",
360      "currency": "USD",
361      "retail_rate": "37.90",
362      "retail_currency": "USD",
363      "list_rate": "33.10",
364      "list_currency": "USD",
365      "billing_type": "easypost",
366      "delivery_days": null,
367      "delivery_date": null,
368      "delivery_date_guaranteed": false,
369      "est_delivery_days": null,
370      "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
371      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
372    },
373    {
374      "id": "rate_5f8a285fa1094e129d121e4dfe59c314",
375      "object": "Rate",
376      "created_at": null,
377      "updated_at": null,
378      "mode": "test",
379      "service": "Priority",
380      "carrier": "USPS",
381      "rate": "6.88",
382      "currency": "USD",
383      "retail_rate": "9.80",
384      "retail_currency": "USD",
385      "list_rate": "8.25",
386      "list_currency": "USD",
387      "billing_type": "easypost",
388      "delivery_days": 2,
389      "delivery_date": null,
390      "delivery_date_guaranteed": false,
391      "est_delivery_days": 2,
392      "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
393      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
394    },
395    {
396      "id": "rate_836fd4e6359e4e40bc27bc39eff5b432",
397      "object": "Rate",
398      "created_at": null,
399      "updated_at": null,
400      "mode": "test",
401      "service": "GroundAdvantage",
402      "carrier": "USPS",
403      "rate": "5.07",
404      "currency": "USD",
405      "retail_rate": "6.70",
406      "retail_currency": "USD",
407      "list_rate": "5.07",
408      "list_currency": "USD",
409      "billing_type": "easypost",
410      "delivery_days": 3,
411      "delivery_date": null,
412      "delivery_date_guaranteed": false,
413      "est_delivery_days": 3,
414      "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
415      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
416    },
417    {
418      "id": "rate_d1fe066dc3c844c2984ac13308bf7b3e",
419      "object": "Rate",
420      "created_at": null,
421      "updated_at": null,
422      "mode": "test",
423      "service": "First",
424      "carrier": "USPS",
425      "rate": "5.07",
426      "currency": "USD",
427      "retail_rate": "6.70",
428      "retail_currency": "USD",
429      "list_rate": "5.07",
430      "list_currency": "USD",
431      "billing_type": "easypost",
432      "delivery_days": 3,
433      "delivery_date": null,
434      "delivery_date_guaranteed": false,
435      "est_delivery_days": 3,
436      "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
437      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
438    },
439    {
440      "id": "rate_3b915871b5ff4cccaec973eedde9e4bb",
441      "object": "Rate",
442      "created_at": null,
443      "updated_at": null,
444      "mode": "test",
445      "service": "ParcelSelect",
446      "carrier": "USPS",
447      "rate": "5.07",
448      "currency": "USD",
449      "retail_rate": "6.70",
450      "retail_currency": "USD",
451      "list_rate": "5.07",
452      "list_currency": "USD",
453      "billing_type": "easypost",
454      "delivery_days": 3,
455      "delivery_date": null,
456      "delivery_date_guaranteed": false,
457      "est_delivery_days": 3,
458      "shipment_id": "shp_1df4e5ffe3ed4909b17b23d56f532c69",
459      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
460    }
461  ],
462  "id": "order_b567c8fffd5641608bda48f0bc58e1d6",
463  "object": "Order"
464}