---
title: Unclaim Seat
framework: App Store Server API
role: symbol
role_heading: Web Service Endpoint
platforms: [app store server api 1.23+]
path: appstoreserverapi/unclaim-seat
---

# Unclaim Seat

Release a claimed seat in a group subscription that uses developer-hosted invitations.

## URL

DELETE https://api.storekit.apple.com/groups/v1/transactions/{originalTransactionId}/seats/{seatClaimId}

## Sandbox URL

DELETE https://api.storekit-sandbox.apple.com/groups/v1/transactions/{originalTransactionId}/seats/{seatClaimId}

## Path Parameters

originalTransactionId: The original transaction identifier of the group purchaser’s subscription. seatClaimId: The identifier of the seat claim, which the Claim Seat endpoint returns.

## Response Codes

200 OK: Request succeeded. 400 Bad Request: Invalid request. See the error code for more information. 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Generating JSON Web Tokens for API requests. 403 Forbidden: The subscription isn’t active. 404 Not Found: The original transaction identifier or the seat claim identifier wasn’t found. 429 : The request exceeded the rate limit. 500 Internal Server Error: Server error. Try again later.

## Mentioned in

App Store Server API changelog

## Discussion

Discussion important: This endpoint is only available in the sandbox environment. Call this endpoint only for an active group subscription that uses developer-hosted invitations, where the invitationManagement value in the purchaser’s transaction is DEVELOPER. Unclaim a seat when a member leaves the group or the group purchaser removes them, and revoke that member’s access in your system. If the number of claimed seats is then lower than the totalSeatCount, a seat becomes available to claim. When the group purchaser reduces the number of seats, the change takes effect at the next renewal date. Outside of a refund, the number of seats doesn’t go down during a subscription period. The App Store doesn’t unclaim any seats when the subscription renews. If the number of claimed seats exceeds the number of seats in the subscription after it renews, call this endpoint to release the excess seats. When you receive a DID_CHANGE_RENEWAL_PREF notification with a subtype of DECREASE_QUANTITY, compare its renewalQuantity with the number of claimed seats. If more seats are claimed than renew, ask the group purchaser before the renewal date which members to remove, and then unclaim those seats on or after the renewal date. To get the identifiers of the active seat claims, call the Get Seat Info endpoint. The App Store can unclaim seats in response to a customer event. When it does, you receive an UNCLAIM_SEATS notification that identifies the seats. For more information, see unclaimInfo.

## See Also

### Seat management

- [Get Seat Info](appstoreserverapi/get-seat-info.md)
- [GetSeatInfoResponse](appstoreserverapi/getseatinforesponse.md)
- [Claim Seat](appstoreserverapi/claim-seat.md)
- [ClaimSeatRequest](appstoreserverapi/claimseatrequest.md)
- [ClaimSeatResponse](appstoreserverapi/claimseatresponse.md)
- [Associate Seat](appstoreserverapi/associate-seat.md)
- [AssociateSeatRequest](appstoreserverapi/associateseatrequest.md)