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.
If you don't provide any carriers, the response will include all carrier services that you have configured in Shipup.
{
"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": "base",
"delivery_date": "2024-02-28",
"safe_delivery_date": "2024-02-29",
"cutoff_datetime_utc": "2024-02-26T14:00:00.000Z"
},
{
"carrier_code": "chronopost",
"service_code": "base",
"delivery_date": "2024-02-29",
"safe_delivery_date": "2024-03-01",
"cutoff_datetime_utc": "2024-02-26T17:00:00.000Z"
}
],
"best_estimation": {
"carrier_code": "colissimo",
"service_code": "base",
"delivery_date": "2024-02-28",
"safe_delivery_date": "2024-02-29",
"cutoff_datetime_utc": "2024-02-26T14:00:00.000Z"
}
}
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": "2024-07-27"
},
"carriers": [
{
"code": "colissimo",
"service_code": null
}
]
}
}
{
"delivery_date_estimations": [
{
"carrier_code": "colissimo",
"service_code": "base",
"delivery_date": "2024-02-28",
"safe_delivery_date": "2024-02-29",
"cutoff_datetime_utc": "2024-02-26T14:00:00.000Z"
}
],
"best_estimation": {
"carrier_code": "colissimo",
"service_code": "base",
"delivery_date": "2024-02-28",
"safe_delivery_date": "2024-02-29",
"cutoff_datetime_utc": "2024-02-26T14:00:00.000Z"
}
}