<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/subscription-offer-codes",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Subscription Offer Codes"
}
-->

# Subscription Offer Codes

Create and manage subscription offers for auto-renewable subscriptions, including one-time use offer codes, and custom offer codes.

## Topics

### Creating and Managing Subscription Offers

[`Create a subscription offer`](/documentation/AppStoreConnectAPI/POST-v1-subscriptionOfferCodes)

Create a subscription offer that provides offer codes for an auto-renewable subscription.

[`Read subscription offer code information`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodes-_id_)

Get details about a specific subscription offer that has offer codes for an auto-renewable subscription.

[`Deactivate a subscription offer with offer codes`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionOfferCodes-_id_)

Deactivate a subscription offer that has offer codes for an auto-renewable subscription.

[`List all subscription offer code prices`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodes-_id_-prices)

Get a list of price tiers for a subscription offer code.

[`List price IDs for a subscription offer code`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodes-_id_-relationships-prices)

Get a list of price resource IDs for a specific subscription offer code.

### Managing One-Time Use Offer Codes

[`Create one-time use offer codes`](/documentation/AppStoreConnectAPI/POST-v1-subscriptionOfferCodeOneTimeUseCodes)

Create one-time use codes for an auto-renewable subscription offer.

[`Read one-time use offer code information`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodeOneTimeUseCodes-_id_)

Get details about a specific one-time use offer code for an auto-renewable subscription.

[`Deactivate one-time use offer codes`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionOfferCodeOneTimeUseCodes-_id_)

Deactivate a batch of one-time use offer codes for an auto-renewable subscription.

[`List all one-time use offer codes for an auto-renewable subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodes-_id_-oneTimeUseCodes)

Get details about a one-time use code for a specific subscription offer for an auto-renewable subscription.

[`List one-time use offer code values`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodeOneTimeUseCodes-_id_-values)

Get a list of one-time use offer codes for an auto-renewable subscription in CSV format.

[`List one-time use code IDs for a subscription offer code`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodes-_id_-relationships-oneTimeUseCodes)

Get a list of one-time use code resource IDs for a specific subscription offer code.

### Managing Custom Offer Codes

[`Create custom offer codes`](/documentation/AppStoreConnectAPI/POST-v1-subscriptionOfferCodeCustomCodes)

Create custom offer codes for an auto-renewable subscription offer.

[`List all custom offer codes for an auto-renewable subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodes-_id_-customCodes)

Get details about a custom code for a specific subscription offer for an auto-renewable subscription.

[`List custom code IDs for a subscription offer code`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodes-_id_-relationships-customCodes)

[`Read custom offer code information`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionOfferCodeCustomCodes-_id_)

Get details about a specific offer code for an auto-renewable subscription.

[`Deactivate custom offer codes`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionOfferCodeCustomCodes-_id_)

Deactivate a batch of custom offer codes for an auto-renewable subscription.

### Objects and types

[`SubscriptionOfferCodeResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeResponse)

The response body for endpoints that create, read, or modify a single subscription offer code.

[`SubscriptionOfferCode`](/documentation/AppStoreConnectAPI/SubscriptionOfferCode)

A promotional code that gives customers a discounted or free subscription for a specified duration and eligibility group.

[`SubscriptionOfferCodeCustomCodesResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeCustomCodesResponse)

A response containing a list of custom promotional codes for a subscription offer.

[`SubscriptionOfferCodeCustomCode`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeCustomCode)

A merchant-defined alphanumeric promotional code granting a discounted or free subscription to the customer who redeems it.

[`SubscriptionOfferCodeOneTimeUseCodeValue`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeOneTimeUseCodeValue)

The alphanumeric code string and associated metadata for a one-time-use subscription offer code.

[`SubscriptionOfferCodeOneTimeUseCodesResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeOneTimeUseCodesResponse)

A response containing a list of Apple-generated one-time-use promotional codes for a subscription offer.

[`SubscriptionOfferCodeOneTimeUseCode`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeOneTimeUseCode)

A single-use promotional code generated by Apple that grants a discounted or free subscription to the recipient.

[`csv`](/documentation/AppStoreConnectAPI/csv)

A string that represents a CSV-formatted report.

[`SubscriptionOfferCodePricesResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodePricesResponse)

A response containing a list of territory-specific prices for a subscription offer code.

[`SubscriptionOfferCodePrice`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodePrice)

The territory-specific customer price and duration for a subscription promotional offer code.

[`SubscriptionOfferCodeCreateRequest`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeCreateRequest)

The request body you use to create a subscription offer code.

[`SubscriptionOfferCodeCustomCodeCreateRequest`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeCustomCodeCreateRequest)

The request body you use to create a subscription offer code custom code.

[`SubscriptionOfferCodeCustomCodeResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeCustomCodeResponse)

A response containing a single custom promotional code for a subscription offer.

[`SubscriptionOfferCodeCustomCodeUpdateRequest`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeCustomCodeUpdateRequest)

The request body you use to update a subscription offer code custom code update request.

[`SubscriptionOfferCodeOneTimeUseCodeCreateRequest`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeOneTimeUseCodeCreateRequest)

The request body you use to create a subscription offer code one-time-use code.

[`SubscriptionOfferCodeOneTimeUseCodeResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeOneTimeUseCodeResponse)

A response containing a single Apple-generated one-time-use promotional code.

[`SubscriptionOfferCodeOneTimeUseCodeUpdateRequest`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeOneTimeUseCodeUpdateRequest)

The request body you use to update a subscription offer code one time use code update request.

[`SubscriptionOfferCodePriceInlineCreate`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodePriceInlineCreate)

An inline object for specifying territory-specific pricing when creating a subscription offer code.

[`SubscriptionOfferCodeUpdateRequest`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeUpdateRequest)

The request body you use to update a subscription offer code update request.

[`SubscriptionOfferCodeCustomCodesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeCustomCodesLinkagesResponse)

[`SubscriptionOfferCodeOneTimeUseCodeValuesLinkageResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeOneTimeUseCodeValuesLinkageResponse)

[`SubscriptionOfferCodeOneTimeUseCodesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeOneTimeUseCodesLinkagesResponse)

[`SubscriptionOfferCodePricesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodePricesLinkagesResponse)

[`SubscriptionOfferCodesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodesLinkagesResponse)


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)