Discussions

Ask a Question

Logo through API

Is there a way to get the logo of the courier services through easyship api? Please advise.

UPS not included in quote

How do I get UPS rates to show up in an API call? I've accepted the terms and conditions in the dashboard. I am getting rates from Sendle and USPS, but no UPS.

USPS rates higher than retail

The API doesn't seem to be returning accurate rates for USPS. I am getting rates higher than retail pricing. A 12oz, 9x6x2 inch package to zone 9 should be $5.33 for commercial rates and $6.65. The API returns $6.78. How do I ensure I am getting commercial rates? USPS rate table for reference: https://pe.usps.com/cpim/ftp/manuals/dmm300/notice123.pdf I am sending the below to `https://api.easyship.com/2023-01/rates` via a POST request ```{ "origin_address": { "state": "CA", "city": "Bethesda", "postal_code": "20814", "contact_phone": "323-863-5656", "line_1": "7400 Wisconsin Ave" }, "destination_address": { "line_1": "900 Wilshire Blvd", "state": "CA", "city": "Los Angeles", "postal_code": "90017", "country_alpha2": "US", "contact_phone": "3238635656" }, "incoterms": "DDU", "insurance": { "is_insured": false }, "courier_selection": { "apply_shipping_rules": true }, "shipping_settings": { "units": { "weight": "oz", "dimension": "in" } }, "parcels": [ { "box": { "length": 9, "width": 6, "height": 2 }, "items": [ { "quantity": 1, "declared_currency": "USD", "declared_customs_value": 1, "hs_code": "6103.10" } ], "total_actual_weight": 12 } ] }``` This is the response: ```{ "rates": [ { "additional_services_surcharge": 0.0, "available_handover_options": [ "dropoff", "free_pickup" ], "courier_id": "7505df80-af51-46a0-b2ee-ac9eacfcd3e4", "courier_name": "USPS - Priority Mail", "courier_remarks": null, "currency": "USD", "ddp_handling_fee": 0.0, "delivery_time_rank": 2.0, "description": "No additional taxes to be paid at delivery", "discount": { "amount": 0, "origin_amount": 0 }, "easyship_rating": null, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "full_description": "USPS - Priority Mail (2-3 working days) No additional taxes to be paid at delivery", "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "incoterms": "DDU", "insurance_fee": 0.0, "is_above_threshold": false, "max_delivery_time": 3, "min_delivery_time": 2, "minimum_pickup_fee": 0.0, "other_surcharges": null, "oversized_surcharge": 0.0, "payment_recipient": "Easyship", "provincial_sales_tax": 0.0, "rates_in_origin_currency": { "additional_services_surcharge": 0.0, "currency": "USD", "ddp_handling_fee": 0.0, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "insurance_fee": 0.0, "minimum_pickup_fee": 0.0, "oversized_surcharge": 0.0, "provincial_sales_tax": 0.0, "remote_area_surcharge": 0.0, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 10.07, "shipment_charge_total": 10.07, "total_charge": 10.07, "warehouse_handling_fee": 0.0 }, "remote_area_surcharge": 0.0, "remote_area_surcharges": null, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 10.07, "shipment_charge_total": 10.07, "total_charge": 10.07, "tracking_rating": 1.0, "value_for_money_rank": 1.0, "warehouse_handling_fee": 0.0 }, { "additional_services_surcharge": 0.0, "available_handover_options": [ "dropoff", "free_pickup" ], "courier_id": "c3e97b11-2842-44f1-84d1-afaa6b3f0a7c", "courier_name": "USPS - First Class", "courier_remarks": null, "currency": "USD", "ddp_handling_fee": 0.0, "delivery_time_rank": 3.0, "description": "No additional taxes to be paid at delivery", "discount": { "amount": 0, "origin_amount": 0 }, "easyship_rating": null, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "full_description": "USPS - First Class (3-4 working days) No additional taxes to be paid at delivery", "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "incoterms": "DDU", "insurance_fee": 0.0, "is_above_threshold": false, "max_delivery_time": 4, "min_delivery_time": 3, "minimum_pickup_fee": 0.0, "other_surcharges": null, "oversized_surcharge": 0.0, "payment_recipient": "Easyship", "provincial_sales_tax": 0.0, "rates_in_origin_currency": { "additional_services_surcharge": 0.0, "currency": "USD", "ddp_handling_fee": 0.0, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "insurance_fee": 0.0, "minimum_pickup_fee": 0.0, "oversized_surcharge": 0.0, "provincial_sales_tax": 0.0, "remote_area_surcharge": 0.0, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 6.78, "shipment_charge_total": 6.78, "total_charge": 6.78, "warehouse_handling_fee": 0.0 }, "remote_area_surcharge": 0.0, "remote_area_surcharges": null, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 6.78, "shipment_charge_total": 6.78, "total_charge": 6.78, "tracking_rating": 1.0, "value_for_money_rank": 2.0, "warehouse_handling_fee": 0.0 }, { "additional_services_surcharge": 0.0, "available_handover_options": [ "dropoff", "free_pickup" ], "courier_id": "2bd30fb9-8f41-4fc3-950d-3675494ae318", "courier_name": "USPS - Parcel Select", "courier_remarks": null, "currency": "USD", "ddp_handling_fee": 0.0, "delivery_time_rank": 6.0, "description": "No additional taxes to be paid at delivery", "discount": { "amount": 0, "origin_amount": 0 }, "easyship_rating": null, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "full_description": "USPS - Parcel Select (2-8 working days) No additional taxes to be paid at delivery", "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "incoterms": "DDU", "insurance_fee": 0.0, "is_above_threshold": false, "max_delivery_time": 8, "min_delivery_time": 2, "minimum_pickup_fee": 0.0, "other_surcharges": null, "oversized_surcharge": 0.0, "payment_recipient": "Easyship", "provincial_sales_tax": 0.0, "rates_in_origin_currency": { "additional_services_surcharge": 0.0, "currency": "USD", "ddp_handling_fee": 0.0, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "insurance_fee": 0.0, "minimum_pickup_fee": 0.0, "oversized_surcharge": 0.0, "provincial_sales_tax": 0.0, "remote_area_surcharge": 0.0, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 8.56, "shipment_charge_total": 8.56, "total_charge": 8.56, "warehouse_handling_fee": 0.0 }, "remote_area_surcharge": 0.0, "remote_area_surcharges": null, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 8.56, "shipment_charge_total": 8.56, "total_charge": 8.56, "tracking_rating": 1.0, "value_for_money_rank": 3.0, "warehouse_handling_fee": 0.0 }, { "additional_services_surcharge": 0.0, "available_handover_options": [ "dropoff" ], "courier_id": "13a2e96c-5c98-48fe-86cb-c27d7a3dc2e8", "courier_name": "Export Standard Dropoff", "courier_remarks": null, "currency": "USD", "ddp_handling_fee": 0.0, "delivery_time_rank": 4.0, "description": "No additional taxes to be paid at delivery", "discount": { "amount": 0, "origin_amount": 0 }, "easyship_rating": null, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "full_description": "Export Standard Dropoff (5-6 working days) No additional taxes to be paid at delivery", "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "incoterms": "DDU", "insurance_fee": 0.0, "is_above_threshold": false, "max_delivery_time": 6, "min_delivery_time": 5, "minimum_pickup_fee": 0.0, "other_surcharges": null, "oversized_surcharge": 0.0, "payment_recipient": "Easyship", "provincial_sales_tax": 0.0, "rates_in_origin_currency": { "additional_services_surcharge": 0.0, "currency": "USD", "ddp_handling_fee": 0.0, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "insurance_fee": 0.0, "minimum_pickup_fee": 0.0, "oversized_surcharge": 0.0, "provincial_sales_tax": 0.0, "remote_area_surcharge": 0.0, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 5.44, "shipment_charge_total": 5.44, "total_charge": 5.44, "warehouse_handling_fee": 0.0 }, "remote_area_surcharge": 0.0, "remote_area_surcharges": null, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 5.44, "shipment_charge_total": 5.44, "total_charge": 5.44, "tracking_rating": 2.0, "value_for_money_rank": 4.0, "warehouse_handling_fee": 0.0 }, { "additional_services_surcharge": 0.0, "available_handover_options": [ "free_pickup" ], "courier_id": "259b6850-3687-43e2-83c4-cbe56eebd7d2", "courier_name": "Export Standard Pickup", "courier_remarks": null, "currency": "USD", "ddp_handling_fee": 0.0, "delivery_time_rank": 5.0, "description": "No additional taxes to be paid at delivery", "discount": { "amount": 0, "origin_amount": 0 }, "easyship_rating": null, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "full_description": "Export Standard Pickup (5-6 working days) No additional taxes to be paid at delivery", "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "incoterms": "DDU", "insurance_fee": 0.0, "is_above_threshold": false, "max_delivery_time": 6, "min_delivery_time": 5, "minimum_pickup_fee": 0.0, "other_surcharges": null, "oversized_surcharge": 0.0, "payment_recipient": "Easyship", "provincial_sales_tax": 0.0, "rates_in_origin_currency": { "additional_services_surcharge": 0.0, "currency": "USD", "ddp_handling_fee": 0.0, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "insurance_fee": 0.0, "minimum_pickup_fee": 0.0, "oversized_surcharge": 0.0, "provincial_sales_tax": 0.0, "remote_area_surcharge": 0.0, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 5.44, "shipment_charge_total": 5.44, "total_charge": 5.44, "warehouse_handling_fee": 0.0 }, "remote_area_surcharge": 0.0, "remote_area_surcharges": null, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 5.44, "shipment_charge_total": 5.44, "total_charge": 5.44, "tracking_rating": 2.0, "value_for_money_rank": 5.0, "warehouse_handling_fee": 0.0 }, { "additional_services_surcharge": 0.0, "available_handover_options": [ "dropoff", "free_pickup" ], "courier_id": "a623a62b-5631-4dce-ae15-bbcf89e49c52", "courier_name": "USPS - Priority Mail Express", "courier_remarks": null, "currency": "USD", "ddp_handling_fee": 0.0, "delivery_time_rank": 1.0, "description": "No additional taxes to be paid at delivery", "discount": { "amount": 0, "origin_amount": 0 }, "easyship_rating": null, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "full_description": "USPS - Priority Mail Express (1-2 working days) No additional taxes to be paid at delivery", "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "incoterms": "DDU", "insurance_fee": 0.0, "is_above_threshold": false, "max_delivery_time": 2, "min_delivery_time": 1, "minimum_pickup_fee": 0.0, "other_surcharges": null, "oversized_surcharge": 0.0, "payment_recipient": "Easyship", "provincial_sales_tax": 0.0, "rates_in_origin_currency": { "additional_services_surcharge": 0.0, "currency": "USD", "ddp_handling_fee": 0.0, "estimated_import_duty": 0, "estimated_import_tax": 0, "fuel_surcharge": 0.0, "import_duty_charge": 0.0, "import_tax_charge": 0.0, "import_tax_non_chargeable": 0.0, "insurance_fee": 0.0, "minimum_pickup_fee": 0.0, "oversized_surcharge": 0.0, "provincial_sales_tax": 0.0, "remote_area_surcharge": 0.0, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 44.6, "shipment_charge_total": 44.6, "total_charge": 44.6, "warehouse_handling_fee": 0.0 }, "remote_area_surcharge": 0.0, "remote_area_surcharges": null, "residential_discounted_fee": null, "residential_full_fee": null, "sales_tax": 0.0, "shipment_charge": 44.6, "shipment_charge_total": 44.6, "total_charge": 44.6, "tracking_rating": 1.0, "value_for_money_rank": 6.0, "warehouse_handling_fee": 0.0 } ], "meta": { "pagination": { "page": 1, "next": null, "count": 6 } } }```

No rates for sandbox

Hello, I am trying to integrate easy ship in my UAT env and using the sandbox token. The sandbox env is not returning the rates for a Texas to Massachuessetts shipment. Please let me know when sandbox rates will start working. { "status": "failure", "errors": [ "Sorry, we couldn't find any shipping solutions based on the information provided." ], "request_id": "7be56b9fa4a43733bde531a6f8c6f468", "timestamp": "2023-01-26T18:19:37.687Z" }

Postman collection for v2022.10

Hello, In your API docs, v2022.10 is marked as stable but there is no way to download the postman collection for it. I see v2 has a run in postman button. Where can I get the postman collection for v2022.10? Thanks, Hunain

Rates API - Return is for which box type?

Hi. I just started using my API access. So far, so good. I am testing the Rates API, returning results - great!!! But I hope someone can help me interpret the values I get back from the call. For the return values, I cannot determine the package type being quoted. For the following example, while "USPS - Priority Mail" is being returned, I can't tell if this is for "Package" as opposed to "Flat Rate Box" or something else. For this return, how can I tell which shipment type the rate applies to? I've only fed the call with dimensions and weight, along with all the other required information (see the end of this post to see what I used). I have also tried to add the box slug, but if it is needed, I must not be using it correctly. Am I missing something - where is the package type either specified or derived??? Thanks in advance for any assistance! Here is an example return: "rates": [ { "courier_id": "7505df80-af51-46a0-b2ee-ac9eacfcd3e4", "courier_name": "USPS - Priority Mail", "min_delivery_time": 2, "max_delivery_time": 3, "value_for_money_rank": 1, "delivery_time_rank": 2, "currency": "USD", "shipment_charge": 10.57, "fuel_surcharge": 0, "remote_area_surcharge": 0, "remote_area_surcharges": {}, "other_surcharges": {}, "oversized_surcharge": 0, "additional_services_surcharge": 0, "residential_full_fee": 0, "residential_discounted_fee": 0, "shipment_charge_total": 10.57, "warehouse_handling_fee": 0, "insurance_fee": 0, "sales_tax": 0, "provincial_sales_tax": 0, "ddp_handling_fee": 0, "import_tax_charge": 0, "import_tax_non_chargeable": 0, "import_duty_charge": 0, "total_charge": 10.57, "is_above_threshold": false, "incoterms": "DDU", "estimated_import_tax": 0, "estimated_import_duty": 0, "minimum_pickup_fee": 0, "available_handover_options": "dropoff,free_pickup", "tracking_rating": 1, "easyship_rating": 3.5, "courier_remarks": null, "payment_recipient": "Easyship", "discount": { "amount": 0, "code": null, "percentage": null, "expires_at": null, "origin_amount": 0 }, "rates_in_origin_currency": { "currency": "USD", "shipment_charge": 10.57, "fuel_surcharge": 0, "remote_area_surcharge": 0, "additional_services_surcharge": 0, "oversized_surcharge": 0, "shipment_charge_total": 10.57, "warehouse_handling_fee": 0, "insurance_fee": 0, "ddp_handling_fee": 0, "import_tax_charge": 0, "import_tax_non_chargeable": 0, "import_duty_charge": 0, "residential_discounted_fee": 0, "residential_full_fee": 0, "total_charge": 10.57, "estimated_import_tax": 0, "estimated_import_duty": 0, "sales_tax": 0, "provincial_sales_tax": 0, "minimum_pickup_fee": 0 }, "description": "No additional taxes to be paid at delivery", "full_description": "USPS - Priority Mail (2-3 working days) No additional taxes to be paid at delivery" }, Here is the input to the call: { "origin_address": { "line_1": "123 Main Street", "contact_email": "[email protected]", "state": "IL", "city": "City", "postal_code": "60084", "country_alpha2": "US" }, "destination_address": { "line_1": "9903 Santa Monica BLVD", "contact_email": "[email protected]", "state": "CA", "city": "Beverly Hills", "postal_code": "90210", "country_alpha2": "US" }, "incoterms": "DDU", "insurance": { "is_insured": false }, "courier_selection": { "apply_shipping_rules": true }, "shipping_settings": { "units": { "weight": "lb", "dimension": "in" } }, "parcels": [{ "box": { "length": 8, "width": 8, "height": 1 }, "items": [{ "quantity": 1, "description": "item1", "actual_weight": 1, "declared_currency": "USD", "declared_customs_value": 5, "category": "fashion" } ], "total_actual_weight": 2 } ] }

Flower Delivery

Hi, just wondering if we can use your service to deliver multiple flower bouquets or boxes in one run usually between 5 to 10 bouquets from one pick up location.
ANSWERED

Multi-box Shipments support of Premier Plan?

Hi, Just wondering Premier Plan you provided, shows there's support for muti-box shipments. But I can't find any API reference about implement of multi-box shipments. Could you help me with that? Thanks for your help.
ANSWERED

Error: get rate and create shipment

I have an error when trying call a request to get quota from API: "https://api.easyship.com/2022-10/rates" and I used sandbox token to call it. The response following bellow: "Oops, an unexpected error occurred. Please check your request and try sending it again. You can contact us if the problem persists". This is my request id: "eb5c96a47e8e67d96e83267ec58db787". How I can resolve it? + Response { "status": "failure", "errors": [ "Oops, an unexpected error occurred. Please check your request and try sending it again. You can contact us if the problem persists." ], "request_id": "eb5c96a47e8e67d96e83267ec58db787" } + My body request <?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://api.easyship.com/2022-10/rates', [ 'body' => '{"origin_address":{"state":"Central Singapore Community Development Council","city":"Singapore","postal_code":"200634","country_alpha2":"SG"},"destination_address":{"line_1":"91 Geylang Road","state":"Singapore","city":"Singapore","postal_code":"200634","country_alpha2":"SG"},"incoterms":"DDU","insurance":{"is_insured":true},"courier_selection":{"apply_shipping_rules":true},"shipping_settings":{"units":{"weight":"kg","dimension":"cm"}},"parcels":[{"items":[{"quantity":1,"dimensions":{"length":10,"width":10,"height":10},"actual_weight":0.5,"declared_currency":"SGD","declared_customs_value":10,"category":"fashion"}]}]}', 'headers' => [ 'accept' => 'application/json', 'authorization' => 'Bearer sand_GeEm6pz6/iR/8xvVH3PmsP/vizWDszDNwXvBkVsu+kA=', 'content-type' => 'application/json', ], ]); echo $response->getBody(); Thanks!
ANSWERED

API Pickup Status Variable

I am currently using Zapier to automate a process to send reminder emails to customer who have not shipped their returns back to us yet. To do so, I have set up my automation to look at the "pickup status" variable for the shipment from Easy Ship. It is only supposed to continue if the status is "pending_drop_off". Unfortunately Zapier is still getting the "pending_drop_off" status on orders that were actually shipped back to us several days before the automation ran. Can someone tell me why the status on the order would still be showing "pending_drop_off"? Is there a better variable to check to ensure that the shipment has not been shipped yet?