Dry Ice Shipments

Shippo supports creating labels for shipping dry ice packed shipments by specifying options in the extras field of the Shipment object.

Only currently supported using FedEx and UPS. Your carrier account must be authorized for dry ice shipping in order to use this functionality.

Creating a dry ice shipment

To create a label for a shipment that will contain dry ice, you will need to specify options in the Shipment extra field.

                curl https://api.goshippo.com/shipments/ \
    -H "Authorization: ShippoToken shippo_test_831a7a042784f523b95db65444e6e084b636764b" \
    -d address_from="d799c2679e644279b59fe661ac8fa488" \
    -d address_to="42236bcf36214f62bcc6d7f12f02a849" \
    -d parcels=["7df2ecf8b4224763ab7c71fae7ec8274"] \
    -d extra='{"dry_ice": {"contains_dry_ice": true, "weight": "0.1"}}' \
    -d async=false
              

In the response you’ll get your usual Shipment object with all of the available rates for your dry ice shipment.

{"carrier_accounts":["078870331023437cb917f5187429b093"],"object_created":"2017-08-03T17:54:54.006Z","object_updated":"2017-08-03T17:54:54.006Z","object_id":"5e40ead7cffe4cc1ad45108696162e42","object_owner":"shippotle@goshippo.com","status":"SUCCESS","address_from":{"object_id":"b631001acb534e2bbf7cea94adfd2d00","is_complete":false,"name":"Mr Hippo","company":"","street_no":"","street1":"965 Mission St","validation_results":[],"street2":"APT 572","street3":"","city":"San Francisco","state":"CA","zip":"94103","country":"US","phone":"4151234567","is_residential":null,"test":true},"address_to":{"object_id":"13d8b016de1c4befbdff900cd05ad2da","is_complete":false,"name":"Billy Bob","company":"","street_no":"","street1":"206 1ST ST","validation_results":[],"street2":"STE 202","street3":"","city":"Brooklyn","state":"NY","zip":"11232","country":"US","phone":"4151234567","is_residential":null,"test":true},"parcels":[{"object_state":"VALID","object_created":"2017-08-03T17:54:53.976Z","object_updated":"2017-08-03T17:54:54.024Z","object_id":"6fb5951a0900439b8770bc1814ee5528","object_owner":"shippotle@goshippo.com","template":null,"extra":[],"length":"10.0000","width":"3.0000","height":"3.0000","distance_unit":"in","weight":"1.0000","mass_unit":"lb","value_amount":null,"value_currency":null,"metadata":"","line_items":[],"test":true}],"shipment_date":"2017-08-03T17:54:53.975Z","address_return":{"object_id":"b631001acb534e2bbf7cea94adfd2d00","is_complete":false,"name":"Mr Hippo","company":"","street_no":"","street1":"965 Mission St","validation_results":[],"street2":"APT 572","street3":"","city":"San Francisco","state":"CA","zip":"94103","country":"US","phone":"4151234567","is_residential":null,"test":true},"customs_declaration":null,"extra":{"dry_ice":{"contains_dry_ice":true,"weight":"0.1"}},"rates":[{"object_created":"2017-08-03T17:54:56.057Z","object_id":"d870ae7efc7c45eabf097986d45d4f09","object_owner":"shippotle@goshippo.com","shipment":"6781b0124d2d4f8cbdd24bd589c61460","attributes":["BESTVALUE","CHEAPEST","FASTEST"],"amount":"14.16","currency":"USD","amount_local":"14.16","currency_local":"USD","provider":"FedEx","provider_image_75":"https:\/\/shippo-static.s3.amazonaws.com\/providers\/75\/FedEx.png","provider_image_200":"https:\/\/shippo-static.s3.amazonaws.com\/providers\/200\/FedEx.png","servicelevel":{"name":"Ground","token":"fedex_ground","terms":""},"estimated_days":5,"arrives_by":null,"duration_terms":"","messages":[],"carrier_account":"078870331023437cb917f5187429b093","test":true,"zone":"8"}],"messages":[],"metadata":""}

Create a dry ice shipment label

You can then use any rate object_id that was returned to create a transaction and get your shipping label:

                curl https://api.goshippo.com/transactions \
    -H "Authorization: ShippoToken shippo_test_831a7a042784f523b95db65444e6e084b636764b" \
    -d rate="cf6fea899f1848b494d9568e8266e076"
    -d label_file_type="PDF"
    -d async=false
              

Your transaction response will look the same as any other shipment:

{"object_state":"VALID","status":"SUCCESS","object_created":"2017-08-03T17:55:44.347Z","object_updated":"2017-08-03T17:55:46.086Z","object_id":"fe52964dbfe449efb6210f0caa9fdee8","object_owner":"shippotle@goshippo.com","test":false,"rate":"d870ae7efc7c45eabf097986d45d4f09","tracking_number":"794609767977","tracking_status":"UNKNOWN","eta":null,"tracking_url_provider":"https:\/\/www.fedex.com\/apps\/fedextrack\/?action=track&cntry_code=us&trackingnumber=794609767977","label_url":"https:\/\/shippo-delivery-east.s3.amazonaws.com\/fe52964dbfe449efb6210f0caa9fdee8.pdf?Signature=aF9ujJ%2BOV5pJc24XoTuKeBmfJCQ%3D&Expires=1385930652&AWSAccessKeyId=AKIAJTHP3LLFMYAWALIA","commercial_invoice_url":null,"messages":[],"order":null,"metadata":"","parcel":"6fb5951a0900439b8770bc1814ee5528"}

The following service levels support dry ice shipping:

  Ground
Express Saver
2 Day
2 Day A.M.
Standard Overnight
Priority Overnight
First Overnight 
  All service levels support Dry Ice shipping. 

Get Started Today for Free!

Kick the tires on the best-in-class shipping platform with a free Shippo account.