v1

latestOpenAPI 3.0.0Cabify Api support2026-07-264588127.9 KB

shipment

Ship the specified parcels.

Marks the given parcels as ready to ship using the specified shipping type.

The available shipping types for your account and location can be retrieved from the GET /v1/shipping_types/available endpoint.

post/v1/parcels/ship

Request body

parcel_idsstring[] required

IDs of the parcels to ship.

shipping_type_idstring required

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

pickup_timestring date-time

Desired pickup time. Only applicable for the express modality. Formatted according to RFC 3339, section 5.6.

Example request

{
  "pickup_time": "2021-12-02T10:12:07.753Z"
}

Response

Shipment request accepted and is being processed.

shipping_type_idstring uuid required

UUID of the shipping type used for this shipment.

Example response

{
  "parcels": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tracking_url": "https://logistics.follow.cabify.com/abcdefghi/e"
    }
  ]
}