---
title: "Ship the specified parcels."
method: POST
path: "/v1/parcels/ship"
tags: ["shipment"]
---

# Ship the specified parcels.

`POST /v1/parcels/ship`

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](https://developers.cabify.com/reference/shippingtypesavailable) endpoint.

## Request body

- ShipParcels
  - `parcel_ids` string[], required — IDs of the parcels to ship.
  - `shipping_type_id` string, required — UUID of the shipping type to use. Use [GET /v1/shipping_types/available](https://developers.cabify.com/reference/shippingtypesavailable) to retrieve valid IDs.
  - `pickup_time` string, date-time — Desired pickup time. Only applicable for the `express` modality. Formatted according to RFC 3339, section 5.6.

## Response `202`

Shipment request accepted and is being processed.

- ShipParcelsResponse
  - `parcels` ParcelShipment[], required — List of parcels with their assigned tracking URLs.
    - `id` string, uuid, required — System-generated UUID for this parcel.
    - `tracking_url` string, url — Public URL where the parcel's live tracking can be viewed.
  - `shipping_type_id` string, uuid, required — UUID of the shipping type used for this shipment.

## Other responses

- `400` — Bad request. One or more fields failed validation.
- `401` — Unauthorized. Missing or invalid authentication token.
- `403` — This parcel does not belong to your account, or the chosen shipping type is not available for your account.
- `404` — The parcel or shipping type could not be found. To find valid shipping type IDs, use [GET /v1/shipping_types/available](https://developers.cabify.com/reference/shippingtypesavailable).
- `409` — One or more parcels are in a state that does not allow them to be shipped.

---

[API](https://skmtc.dev/cabify/apis/ride-hailing-api.md) · [All operations](https://skmtc.dev/cabify/apis/ride-hailing-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cabify/ride-hailing-api/revisions/8da1cb1270df/schema)