Sign in

v1

latestOpenAPI 3.0.0Cabify Api support2026-07-264588127.9 KB
shipment

Estimate the cost and timing of a shipment.

Calculates the estimated price, pickup time, and delivery time for the given parcels using the specified shipping type.

post/v3/parcels/estimate

Request body

shipping_type_idstring uuid required

UUID of the shipping type to estimate. Use GET /v1/shipping_types/available to retrieve valid IDs.

pickup_timestring date-time

Desired pickup time, formatted according to RFC 3339, section 5.6.

Example request

{
  "parcels": [
    {
      "external_id": "parcel_001",
      "pickup_location": {
        "lat": 40.4489254,
        "lon": -3.6730293
      },
      "dropoff_location": {
        "lat": 40.4489254,
        "lon": -3.6730293
      },
      "dimensions": {
        "height": 10,
        "length": 10,
        "width": 10
      },
      "weight": {
        "value": 1500
      }
    }
  ],
  "pickup_time": "2021-12-02T10:12:07.753Z"
}

Response

Estimation calculated successfully.

Example response

{
  "deliveries": [
    {
      "parcels": [
        {
          "external_id": "parcel_001",
          "pickup_location": {
            "lat": 40.4489254,
            "lon": -3.6730293
          },
          "dropoff_location": {
            "lat": 40.4489254,
            "lon": -3.6730293
          },
          "dimensions": {
            "height": 10,
            "length": 10,
            "width": 10
          },
          "weight": {
            "value": 1500
          }
        }
      ],
      "estimation": {
        "price": {
          "amount": 630,
          "currency": "EUR"
        },
        "eta_to_pickup": "2021-12-02T10:12:07.753Z",
        "eta_to_delivery": "2021-12-02T10:12:47.753Z"
      }
    }
  ]
}