---
title: "Notify an event for the given parcel."
method: POST
path: "/v1/parcels/{parcel_id}/notify"
tags: ["parcels"]
---

# Notify an event for the given parcel.

`POST /v1/parcels/{parcel_id}/notify`

Sends an event notification for the specified parcel. Currently, only the `ready_to_pickup`
event is supported.

This event is typically used in food delivery workflows to signal that an order is prepared
and ready to be collected by a driver.

## Path parameters

- `parcel_id` string, uuid, required

## Request body

- object — Request body for sending an event notification for a parcel.
  - `event` 'ready_to_pickup', required — The event to notify. Currently, only `ready_to_pickup` is supported, which signals that the order is prepared and ready to be collected by a driver.

## Response `202`

Event accepted and queued for processing.

## Other responses

- `400` — Bad request. One or more fields failed validation.
- `403` — This parcel does not belong to your account.
- `404` — No parcel found with the given ID.
- `409` — The parcel has not yet been assigned to a modality, or the assigned modality does not support this event.
- `422` — Unprocessable entity. The request is well-formed but contains semantic errors.
- `500` — An unexpected server error occurred.

---

[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)