# Cancel Segment
source: https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/use-cases/segment-operations/cancel_segment/index.md

#### Overview {#overview}

**Actors:** Issuer developer, Mastercard Global Benefits Platform  

**Preconditions:** Card has an active segment assigned; the requested expiry date is on or after the segment's effective date  

**Outcome:** The segment and all its associated bundles are expired on the specified expiry date; no new segment is assigned  

**Endpoint:** `PUT /card-segments-cancellations` --- use this endpoint to permanently remove a segment from a card; use [Freeze/Unfreeze](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/use-cases/card-operations/freeze_unfreeze/index.md) if you only need to temporarily suspend benefits

Cancels the segmented benefits associated to the card by taking card number, segment name and expiry date as the input.
The response is an array of bundles that are cancelled on the card for the given expiry date. Exactly one input segment is supported at this time.
Diagram cancel_segment
API Reference: `PUT /card-segments-cancellations`

### Cancel segment associated with a card where the card segment was previously assigned successfully. Most common use case. {#cancel-segment-associated-with-a-card-where-the-card-segment-was-previously-assigned-successfully-most-common-use-case}

1. Cardholder requests the segmented benefit associated with their card be cancelled.
2. Issuer sends a request with a card number, segment code and expiry date as an input parameter
3. Benefit Allocation Service API returns the segment benefit codes cancelled with effective and expiration dates. The expiry date will be the date sent in the request.

## Additional Information {#additional-information}

* If a card has not been assigned it cannot be cancelled.
* In order to assign a new segment its effective date must be after the given expiry date.

Tip: The following operations are allowed to be performed after Cancel Segment: **Assign Segment**

1. Look at the [API Reference](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/api-reference/index.md) for information on how to implement this use case.
2. Look at the [Responses Codes and Error Codes](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/code-and-formats/index.md) for acknowledgement responses.
