---
title: "Get the tip for a parcel."
method: GET
path: "/v1/parcels/{parcel_id}/tip"
tags: ["parcels"]
---

# Get the tip for a parcel.

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

## Request

- Base URL: `https://logistics.api.cabify-sandbox.com`
- URL: `https://logistics.api.cabify-sandbox.com/v1/parcels/{parcel_id}/tip`
- Auth: HTTP bearer

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

Returns the tip configured for the specified parcel, if one exists.

## Path parameters

- `parcel_id` string, uuid, required

## Response `200`

Tip retrieved 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

- `204`: No tip exists for the specified parcel.
- `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.
- `429`: Too many requests. This API is rate limited per account and per endpoint. A 429 is an expected condition rather than a failed request: back off and retry it. The limits are not the same for every endpoint and can change, so handle the status instead of hard-coding a rate. See the Limits and reliability guide.

---

[API](https://skmtc.dev/cabify/apis/cabify-logistics-api.md) - [All operations](https://skmtc.dev/cabify/apis/cabify-logistics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cabify/apis/cabify-logistics-api/revisions/dff49457aac9?raw)