---
title: Configuring multi-seat subscriptions for organizations
framework: App Store Connect API
role: article
role_heading: Article
path: appstoreconnectapi/configuring-multi-seat-subscriptions-for-organizations
---

# Configuring multi-seat subscriptions for organizations

Control whether organizations can purchase an auto-renewable subscription for multiple people, and which markets offer it.

## Overview

Overview Organizations can buy your auto-renewable subscriptions in quantities greater than one through Apple Business Manager (Enterprise) and Apple School Manager (Education). To learn more, see Apple School Manager and Apple Business APIs. Use the multiSeatStatus and marketSettings attributes on the subscriptions resource to control whether a subscription supports these multi-seat purchases and which markets offer it. Both attributes apply only to auto-renewable subscriptions; updating them on any other in-app purchase type returns an error. Before you configure multi-seat settings, create an auto-renewable subscription as described in Managing auto-renewable subscriptions. To update these attributes, be sure you have one of the following user roles: ACCOUNT_HOLDER ADMIN APP_MANAGER API keys with the MARKETING role have read-only access to both attributes. Turn multi-seat purchasing on or off Every auto-renewable subscription defaults to multiSeatStatus of ENABLED, so you only need to set this attribute when you want to change a subscription’s current state. To update it, use Modify an auto-renewable subscription with a payload that sets the multiSeatStatus. Here’s an example payload that turns multi-seat purchasing on for a subscription: {   "data": {     "type": "subscriptions",     "id": "6446671421",     "attributes": {       "multiSeatStatus": "ENABLED"     }   } } The multiSeatStatus attribute accepts the following values:  |   |   |  note: Turning on Family Sharing for a subscription automatically sets multiSeatStatus to DISABLED. If you turn multi-seat purchasing back on for a family-shareable subscription, Family Sharing only applies when the a single seat is purchased. Choose which markets offer multi-seat purchases After you turn on multi-seat purchasing, use the marketSettings attribute to choose which markets support multi-seat purchases of the subscription. Update it with the same PATCH /v1/subscriptions/{id} (Modify an auto-renewable subscription) endpoint, providing an array of markets. Here’s an example payload that makes a subscription available for multi-seat purchase on the App Store and through Apple Business Manager, but not Apple School Manager: {   "data": {     "type": "subscriptions",     "id": "6446671421",     "attributes": {       "marketSettings": [         "APP_STORE",         "APPLE_BUSINESS"       ]     }   } } marketSettings accepts an array containing any of the following values:  |   |   |   |  important: marketSettings only has an effect while multiSeatStatus is ENABLED. If multiSeatStatus is DISABLED, the subscription isn’t available for multi-seat purchase in any market, regardless of which values you set in marketSettings. Verify your configuration To confirm the current settings, use GET /v1/subscriptions/{id} (Read subscription information) and check the multiSeatStatus and marketSettings values in the response. For example: GET /v1/subscriptions/6446671421 Here’s the example response, truncated for clarity: {   "data" : {     "type" : "subscriptions",     "id" : "6446671421",     "attributes" : {       "multiSeatStatus" : "ENABLED",       "marketSettings" : [ "APP_STORE", "APPLE_BUSINESS" ]     }   } }

## See Also

### Managing Auto-Renewable Subscriptions

- [Managing auto-renewable subscriptions](appstoreconnectapi/managing-auto-renewable-subscriptions.md)
- [Working with subscription versions](appstoreconnectapi/working-with-subscription-versions.md)
- [Configuring subscription prices across territories](appstoreconnectapi/configuring-subscription-prices-across-territories.md)
- [Querying adjusted subscription price equalizations](appstoreconnectapi/querying-adjusted-subscription-price-equalizations.md)
- [Subscription Versions](appstoreconnectapi/subscription-versions.md)
- [Subscriptions](appstoreconnectapi/subscriptions.md)
- [Subscription Localizations](appstoreconnectapi/subscription-localizations.md)
- [Subscription localizations (v1)](appstoreconnectapi/subscription-localizations-v1.md)
- [Subscription price points and subscription prices](appstoreconnectapi/subscription-price-points-and-subscription-prices.md)
- [Subscription images](appstoreconnectapi/subscription-images.md)
- [Subscription images (v1)](appstoreconnectapi/subscription-images-v1.md)
- [Subscription availability](appstoreconnectapi/subscription-availability.md)
- [Subscription plan availability](appstoreconnectapi/subscription-plan-availability.md)
- [Billing Grace Periods](appstoreconnectapi/billing-grace-periods.md)