---
title: "Add a tip for a parcel delivery."
method: POST
path: "/v1/parcels/{parcel_id}/tip"
tags: ["parcels"]
---

# Add a tip for a parcel delivery.

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

> **Note:** This feature is not available to all clients. Please contact us before using it.

Adds a tip for the driver in the event of a successful delivery. The tip can be set at any
point before the parcel is delivered. The tip amount must be formatted according to ISO 4217
(e.g. €6.30 → `630` in EUR).

## Path parameters

- `parcel_id` string, uuid, required

## Request body

- CreateTip
  - `amount` integer, required — Tip amount in the smallest currency unit, following the ISO 4217 standard (e.g. €6.30 → `630`).

## Response `200`

Tip created successfully.

- Tip
  - `parcel_id` string, uuid — UUID of the parcel this tip is associated with.
  - `amount` integer — Tip amount in the smallest currency unit, following the ISO 4217 standard (e.g. €6.30 → `630`).
  - `currency` string — ISO 4217 currency code.

## Other responses

- `401` — Unauthorized. Missing or invalid authentication token.
- `403` — This parcel does not belong to your account, or your account is not allowed to use the tipping feature.
- `404` — No parcel found with the given ID.
- `409` — A tip already exists for this parcel.
- `429` — The parcel's current state does not allow adding a tip.

---

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