POST /v1/delivery_date_estimation

You can query the Shipup API in order to retrieve the Smart Delivery Estimate for a specific order.

Endpoint:

  • Description: Retrieves delivery date estimations for a given order
  • URL: https://api.shipup.co/v1/delivery_date_estimation
  • Method: POST
  • Headers: Authorization: Bearer [PUBLIC_API_KEY]

🚧

API key

Contrary to other API routes, this route requires your public API key.
You can find it in your settings page. Keys are located at the bottom of the page.

This endpoint returns a JSON payload containing for each couple of carrier_code / service_code the most likely delivery date.

Example of basic request

With an empty payload

curl -X POST -H "Authorization: Bearer [PUBLIC_API_KEY]" -d "{}" https://api.shipup.co/v1/delivery_date_estimation

Building the payload

On the right, two valid requests and responses are displayed.

πŸ“˜

All request parameters are optional - the more you provide, the more accurate the response will be.

With 2 carriers:
{
  "delivery_date_estimation": {
    "origin": {
      "country_code": "FR",
      "city": "Montpellier"
    },
    "destination": {
      "country_code": "FR",
      "city": "Paris"
    },
    "carriers": [
      {
        "code": "colissimo",
        "service_code": null
      },
      {
        "code": "chronopost",
        "service_code": null
      }
    ]
  }
}
{
  "delivery_date_estimations": [
    {
      "carrier_code": "colissimo",
      "service_code": null,
      "delivery_date": "2020-06-02"
    },
    {
      "carrier_code": "chronopost",
      "service_code": null,
      "delivery_date": "2020-06-02"
    }
  ]
}
When the order.merchant_shipping_date is specified:

{
  "delivery_date_estimation": {
    "origin": {
      "country_code": "FR",
      "city": "Montpellier"
    },
    "destination": {
      "country_code": "FR",
      "city": "Paris"
    },
    "order": {
      "merchant_shipping_date": "2020-07-28"
    },
    "carriers": [
      {
        "code": "colissimo",
        "service_code": null
      }
    ]
  }
}
{
  "delivery_date_estimations": [
    {
      "carrier_code": "colissimo",
      "service_code": null,
      "delivery_date": "2020-07-30"
    }
  ]
}

Object Reference

πŸ“˜

The object reference for the delivery date estimation API is the same as for the ShipupETA JS library. Both object references are available in the ShipupETA documentation.