---
title: Revoke Subscription
framework: advancedcommerceapi
role: symbol
role_heading: Web Service Endpoint
path: advancedcommerceapi/revoke-subscription
---

# Revoke Subscription

Immediately cancel a customer’s subscription and all the items that are included in the subscription, and request a full or prorated refund.

## URL

POST https://api.storekit.itunes.apple.com/advancedCommerce/v1/subscription/revoke/{transactionId}

## Sandbox URL

POST https://api.storekit-sandbox.itunes.apple.com/advancedCommerce/v1/subscription/revoke/{transactionId}

## Path Parameters

transactionId: The transaction identifier of the auto-renewable subscription to revoke. Use the subscription’s original transaction ID or any subsequent transaction ID of a transaction related to the subscription.

## Response Codes

200 OK: Request succeeded. 400 Bad Request: 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Authorizing API requests from your server. 403 Forbidden: 404 Not Found: 429 : The request exceeded the rate limit. For more information, see Identifying rate limits for Advanced Commerce APIs. 500 Internal Server Error: Server error. Try again later.

## Mentioned in

Authorizing API requests from your server Advanced Commerce API changelog Identifying rate limits for Advanced Commerce APIs

## Discussion

Discussion When this endpoint succeeds, the system sets the subscription’s auto-renew status to false, and revokes the subscription with a full or prorated refund. The App Store Server Notifications sends a REFUND  notificationType to your App Store Server Notifications V2 endpoint. Check the revocationDate property in the notification’s  JWSTransactionDecodedPayload. Turn off service for the subscription and its items as of the revocation date. Don’t turn off service to the subscription until you receive the notification. To cancel a subscription at the end of the current period instead, see Cancel a Subscription. note: To use the Revoke Subscription endpoint, your membership Account Holder must sign the Advanced Commerce API Addendum, and you must meet certain eligibility requirements. For more information, see Advanced Commerce API. If the most recent version of this agreement isn’t yet accepted, you can’t call this endpoint, and it returns an error. Refer to the Advanced Commerce API Addendum to learn the use cases for the Cancel a Subscription, Revoke Subscription, and Request Transaction Refund APIs.

## See Also

### Subscription revocation from the server

- [SubscriptionRevokeRequest](advancedcommerceapi/subscriptionrevokerequest.md)
- [SubscriptionRevokeResponse](advancedcommerceapi/subscriptionrevokeresponse.md)