---
title: "Void a Label By ID"
method: PUT
path: "/v1/labels/{label_id}/void"
tags: ["labels"]
---

# Void a Label By ID

`PUT /v1/labels/{label_id}/void`

Void a label by ID to get a refund.

## Response `200`

The request was a success.

- VoidLabelResponseBody — A void label response body
  - `approved` boolean, required — Indicates whether the attempt to void the label was successful
  - `message` string, required
  - `reason_code` 'unknown' | 'unspecified' | 'validation_failed' | 'label_not_found_within_void_period' | 'label_already_used' | 'label_already_voided' | 'contact_carrier' — The possible normalized reasons a label void request may not have been approved

## Other responses

- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

---

[API](https://skmtc.net/shipengine/apis/shipengine-api.md) · [All operations](https://skmtc.net/shipengine/apis/shipengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipengine/shipengine-api/revisions/6af91511d87e/schema)