---
title: ClaimSeatRequest
framework: App Store Server API
role: symbol
role_heading: Object
platforms: [app store server api 1.23+]
path: appstoreserverapi/claimseatrequest
---

# ClaimSeatRequest

The request body that contains the information to claim a seat in a group subscription that uses developer-hosted invitations.

## Declaration

```data
object ClaimSeatRequest
```

## Properties

requestIdentifier: Required. A unique identifier you generate for the claim, which makes the request safe to repeat. appTransactionId: The app transaction identifier of the customer who occupies the seat. Include this value if you know it when you claim the seat.

## Mentioned in

App Store Server API changelog

## Discussion

Discussion This is the request body for the Claim Seat endpoint. Generate a new requestIdentifier for each claim, and save it before you call the endpoint. If the request fails or times out, retry it with the same requestIdentifier. If the original request claimed a seat, the endpoint returns that seatClaimId instead of claiming a second seat. If you include the appTransactionId, the App Store associates the customer with the seat as part of the claim. If you learn the appTransactionId later, call the Associate Seat endpoint.

## See Also

### Seat management

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