<!--
{
  "documentType" : "article",
  "framework" : "AdvancedCommerceAPI",
  "identifier" : "/documentation/AdvancedCommerceAPI/datatypes",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Data types"
}
-->

# Data types

Objects and data types for the Advanced Commerce API.

## Topics

### Objects

[`object Descriptors`](/documentation/AdvancedCommerceAPI/Descriptors)

The display name and description of a subscription product.

[`object Offer`](/documentation/AdvancedCommerceAPI/Offer)

A discount offer for an auto-renewable subscription.

[`object RequestInfo`](/documentation/AdvancedCommerceAPI/RequestInfo)

The metadata to include in server requests.

[`object SubscriptionModifyAddItem`](/documentation/AdvancedCommerceAPI/SubscriptionModifyAddItem)

The data your app provides to add items when it makes changes to an auto-renewable subscription.

[`object SubscriptionModifyChangeItem`](/documentation/AdvancedCommerceAPI/SubscriptionModifyChangeItem)

The data your app provides to change an item of an auto-renewable subscription.

[`object SubscriptionModifyDescriptors`](/documentation/AdvancedCommerceAPI/SubscriptionModifyDescriptors)

The data your app provides to change the description and display name of an auto-renewable subscription.

[`object SubscriptionModifyPeriodChange`](/documentation/AdvancedCommerceAPI/SubscriptionModifyPeriodChange)

The data your app provides to change the period of an auto-renewable subscription.

[`object SubscriptionModifyRemoveItem`](/documentation/AdvancedCommerceAPI/SubscriptionModifyRemoveItem)

The data your app provides to remove an item from an auto-renewable subscription.

[`object SubscriptionPriceChangeItem`](/documentation/AdvancedCommerceAPI/SubscriptionPriceChangeItem)

The data your app provides to change a subscription price.

### Data types

[`string currency`](/documentation/AdvancedCommerceAPI/currency)

The three-letter ISO 4217 currency code for the price of a product.

[`string description`](/documentation/AdvancedCommerceAPI/description)

A string you provide that describes a SKU.

[`string dependentSKU`](/documentation/AdvancedCommerceAPI/dependentSKU)

The product identifier of a dependent SKU in a subscription price change.

[`string displayName`](/documentation/AdvancedCommerceAPI/displayName)

A string with a product name that you can localize and is suitable for display to customers.

[`string effective`](/documentation/AdvancedCommerceAPI/effective)

A string value that indicates when a requested change to an auto-renewable subscription goes into effect.

[`string period`](/documentation/AdvancedCommerceAPI/period)

The duration of a single cycle of an auto-renewable subscription.

[`int64 price`](/documentation/AdvancedCommerceAPI/price)

A price, in milliunits of a currency, for an Advanced Commerce API SKU.

[`int64 proratedPrice`](/documentation/AdvancedCommerceAPI/proratedPrice)

A prorated price, in milliunits of a currency, for an Advanced Commerce API SKU.

[`boolean retainBillingCycle`](/documentation/AdvancedCommerceAPI/retainBillingCycle)

A Boolean value that determines whether to keep the existing billing cycle with the change you request.

[`integer refundAmount`](/documentation/AdvancedCommerceAPI/refundAmount)

A refund amount, in milliunits of the currency.

[`string refundReason`](/documentation/AdvancedCommerceAPI/refundReason)

A reason to request a refund.

[`boolean refundRiskingPreference`](/documentation/AdvancedCommerceAPI/refundRiskingPreference)

A Boolean value that indicates whether the App Store asks you for consumption data to help inform the refund decision.

[`string SKU`](/documentation/AdvancedCommerceAPI/SKU)

The product identifier of an Apple In-App Purchase product you manage in your own system.

[`string storefront`](/documentation/AdvancedCommerceAPI/storefront)

A three-letter code that represents the country or region associated with the App Store storefront.

[`string taxCode`](/documentation/AdvancedCommerceAPI/taxCode)

A tax code that applies to a SKU.

[`string targetProductId`](/documentation/AdvancedCommerceAPI/targetProductId)

A generic product identifier that represents all Advanced Commerce API products to App Store Connect, which you use when you migrate a product.

[`string transactionId`](/documentation/AdvancedCommerceAPI/transactionId)

A unique identifier that the App Store generates for a transaction.

[`string version`](/documentation/AdvancedCommerceAPI/version)

A number that represents the version of the data structure or Advanced Commerce API.


---

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)