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

# Get Seat Info

Get the seat counts and the seat claims of a group subscription that uses developer-hosted invitations.

## URL

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

## Sandbox URL

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

## Path Parameters

originalTransactionId: The original transaction identifier of the group purchaser’s subscription.

## 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 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. Your app hosts the invitations to these subscriptions, and you claim a seat for each member by calling the Claim Seat endpoint. The response, GetSeatInfoResponse, contains: The total number of seats in the subscription, totalSeatCount. The number of seats that are available to claim, availableSeatCount. The identifiers of the active seat claims, in the assignedSeatClaimIds array. The first seat always belongs to the group purchaser, so it’s never available to claim. Use this endpoint to show the number of available seats in your invitation experience, and to recover the seatClaimId of a claimed seat if your records don’t contain it. If the group purchaser reduces the number of seats, the App Store doesn’t unclaim any seats when the subscription renews. As a result, the number of claimed seats can be greater than totalSeatCount. To release seats, call the Unclaim Seat endpoint, which describes how to handle a smaller group at renewal.

## See Also

### Seat management

- [GetSeatInfoResponse](appstoreserverapi/getseatinforesponse.md)
- [Claim Seat](appstoreserverapi/claim-seat.md)
- [ClaimSeatRequest](appstoreserverapi/claimseatrequest.md)
- [ClaimSeatResponse](appstoreserverapi/claimseatresponse.md)
- [Unclaim Seat](appstoreserverapi/unclaim-seat.md)
- [Associate Seat](appstoreserverapi/associate-seat.md)
- [AssociateSeatRequest](appstoreserverapi/associateseatrequest.md)