latestOpenAPI 3.0.0Proprietary2026-08-22131410675.6 KB

8d8a7cf79204

labels

Void a label by ID

Void a label by ID to get a refund.

put/v1/labels/{label_id}/void

Response

The request was a success.

approvedboolean required

Indicates whether the attempt to void the label was successful

messagestring required
voided_label_idsinteger[]

The Ids of any associated labels that were also voided as part of this request. Includes the originally requested label.

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

Example response

{
  "message": "Unable to delete FedEx shipment. Unable to retrieve record from database."
}