# Error codes Understand the error codes that App Store Server API responses return. ## Topics ### Errors [`AccountNotFoundError`](/documentation/AppStoreServerAPI/AccountNotFoundError) An error that indicates the App Store account wasn’t found. [`AdvancedCommerceTransactionNotSupportedError`](/documentation/AppStoreServerAPI/AdvancedCommerceTransactionNotSupportedError) An error that indicates Advanced Commerce API transactions are not supported by the endpoint. [`AppNotFoundError`](/documentation/AppStoreServerAPI/AppNotFoundError) An error that indicates the app wasn’t found. [`AppTransactionDoesNotExistError`](/documentation/AppStoreServerAPI/AppTransactionDoesNotExistError) An error response that indicates an app transaction doesn’t exist for the specified customer. [`AppTransactionIdNotSupportedError`](/documentation/AppStoreServerAPI/AppTransactionIdNotSupportedError) An error that indicates the endpoint doesn’t support an app transaction ID. [`FamilySharedSubscriptionExtensionIneligibleError`](/documentation/AppStoreServerAPI/FamilySharedSubscriptionExtensionIneligibleError) An error that indicates a subscription isn’t directly eligible for a renewal date extension because the customer obtained it through Family Sharing. [`FamilyTransactionNotSupportedError`](/documentation/AppStoreServerAPI/FamilyTransactionNotSupportedError) An error that indicates the transaction is for a product the customer obtains through Family Sharing, which the endpoint doesn’t support. [`GeneralInternalError`](/documentation/AppStoreServerAPI/GeneralInternalError) An error that indicates a general internal error. [`GeneralBadRequestError`](/documentation/AppStoreServerAPI/GeneralBadRequestError) An error that indicates an invalid request. [`InvalidAppAccountTokenUUIDError`](/documentation/AppStoreServerAPI/InvalidAppAccountTokenUUIDError) An error that indicates the app account token value is not a valid UUID. [`InvalidAppIdentifierError`](/documentation/AppStoreServerAPI/InvalidAppIdentifierError) An error that indicates an invalid app identifier. [`InvalidEmptyStorefrontCountryCodeListError`](/documentation/AppStoreServerAPI/InvalidEmptyStorefrontCountryCodeListError) An error that indicates a required storefront country code is empty. [`InvalidExtendByDaysError`](/documentation/AppStoreServerAPI/InvalidExtendByDaysError) An error that indicates an invalid extend-by-days value. [`InvalidExtendReasonCodeError`](/documentation/AppStoreServerAPI/InvalidExtendReasonCodeError) An error that indicates an invalid reason code. [`InvalidOriginalTransactionIdError`](/documentation/AppStoreServerAPI/InvalidOriginalTransactionIdError) An error that indicates an invalid original transaction identifier. [`InvalidRefundPreferenceError`](/documentation/AppStoreServerAPI/InvalidRefundPreferenceError) An error that indicates an invalid refund preference value. [`InvalidRequestIdentifierError`](/documentation/AppStoreServerAPI/InvalidRequestIdentifierError) An error that indicates an invalid request identifier. [`InvalidRequestRevisionError`](/documentation/AppStoreServerAPI/InvalidRequestRevisionError) An error that indicates an invalid request revision. [`InvalidRevokedError`](/documentation/AppStoreServerAPI/InvalidRevokedError) An error that indicates the revoked parameter contains an invalid value. [`InvalidStatusError`](/documentation/AppStoreServerAPI/InvalidStatusError) An error that indicates the status parameter is invalid. [`InvalidStorefrontCountryCodeError`](/documentation/AppStoreServerAPI/InvalidStorefrontCountryCodeError) An error that indicates a storefront code is invalid. [`InvalidTransactionIdError`](/documentation/AppStoreServerAPI/InvalidTransactionIdError) An error that indicates an invalid transaction identifier. [`OriginalTransactionIdNotFoundError`](/documentation/AppStoreServerAPI/OriginalTransactionIdNotFoundError) An error that indicates an original transaction identifier wasn’t found. [`RateLimitExceededError`](/documentation/AppStoreServerAPI/RateLimitExceededError) An error that indicates the request exceeded the rate limit. [`StatusRequestNotFoundError`](/documentation/AppStoreServerAPI/StatusRequestNotFoundError) An error that indicates the server didn’t find a subscription-renewal-date extension request for the request identifier and product identifier you provided. [`SubscriptionExtensionIneligibleError`](/documentation/AppStoreServerAPI/SubscriptionExtensionIneligibleError) An error that indicates the subscription doesn’t qualify for a renewal-date extension due to its subscription state. [`SubscriptionMaxExtensionError`](/documentation/AppStoreServerAPI/SubscriptionMaxExtensionError) An error that indicates the subscription doesn’t qualify for a renewal-date extension because it has already received the maximum extensions. [`TransactionIdIsNotOriginalTransactionIdError`](/documentation/AppStoreServerAPI/TransactionIdIsNotOriginalTransactionIdError) An error that indicates the endpoint expects an original transaction identifier. [`TransactionIdNotFoundError`](/documentation/AppStoreServerAPI/TransactionIdNotFoundError) An error that indicates a transaction identifier wasn’t found. ### Errors to retry [`AccountNotFoundRetryableError`](/documentation/AppStoreServerAPI/AccountNotFoundRetryableError) An error response that indicates the App Store account wasn’t found, but you can try again. [`AppNotFoundRetryableError`](/documentation/AppStoreServerAPI/AppNotFoundRetryableError) An error response that indicates the app wasn’t found, but you can try again. [`GeneralInternalRetryableError`](/documentation/AppStoreServerAPI/GeneralInternalRetryableError) An error response that indicates an unknown error occurred, but you can try again. [`OriginalTransactionIdNotFoundRetryableError`](/documentation/AppStoreServerAPI/OriginalTransactionIdNotFoundRetryableError) An error response that indicates the original transaction identifier wasn’t found, but you can try again. ### Consumption request errors [`ConsumptionPercentageAutoRenewableSubscriptionError`](/documentation/AppStoreServerAPI/ConsumptionPercentageAutoRenewableSubscriptionError) An error that indicates the consumption percentage field is unsupported for auto-renewable subscription transactions. [`ConsumptionPercentageOutOfRangeError`](/documentation/AppStoreServerAPI/ConsumptionPercentageOutOfRangeError) An error that indicates the consumption percentage is outside the valid range. [`InvalidAccountTenureError`](/documentation/AppStoreServerAPI/InvalidAccountTenureError) An error that indicates the value of the account tenure field is invalid. [`InvalidAppAccountTokenError`](/documentation/AppStoreServerAPI/InvalidAppAccountTokenError) An error that indicates the value of the app account token field is invalid. [`InvalidConsumptionStatusError`](/documentation/AppStoreServerAPI/InvalidConsumptionStatusError) An error that indicates the value of the consumption status field is invalid. [`InvalidCustomerConsentedError`](/documentation/AppStoreServerAPI/InvalidCustomerConsentedError) An error that indicates the customer consented field is invalid or doesn’t indicate that the customer consented. [`InvalidDeliveryStatusError`](/documentation/AppStoreServerAPI/InvalidDeliveryStatusError) An error that indicates the value in the delivery status field is invalid. [`InvalidLifetimeDollarsPurchasedError`](/documentation/AppStoreServerAPI/InvalidLifetimeDollarsPurchasedError) An error that indicates the value in the lifetime dollars purchased field is invalid. [`InvalidLifetimeDollarsRefundedError`](/documentation/AppStoreServerAPI/InvalidLifetimeDollarsRefundedError) An error that indicates the value in the lifetime dollars refunded field is invalid. [`InvalidPlatformError`](/documentation/AppStoreServerAPI/InvalidPlatformError) An error that indicates the value in the platform field is invalid. [`InvalidPlayTimeError`](/documentation/AppStoreServerAPI/InvalidPlayTimeError) An error that indicates the value in the playtime field is invalid. [`InvalidSampleContentProvidedError`](/documentation/AppStoreServerAPI/InvalidSampleContentProvidedError) An error that indicates the value in the sample content provided field is invalid. [`InvalidTransactionTypeNotSupportedError`](/documentation/AppStoreServerAPI/InvalidTransactionTypeNotSupportedError) An error that indicates the transaction identifier represents an unsupported In-App Purchase type. [`InvalidUserStatusError`](/documentation/AppStoreServerAPI/InvalidUserStatusError) An error that indicates the value in the user status field is invalid. [`InvalidTransactionNotConsumableError`](/documentation/AppStoreServerAPI/InvalidTransactionNotConsumableError) An error that indicates the transaction identifier doesn’t represent a consumable In-App Purchase. [`UndeliveredConsumptionPercentageNonZeroError`](/documentation/AppStoreServerAPI/UndeliveredConsumptionPercentageNonZeroError) An error that indicates the consumption percentage must be zero for the provided delivery status. ### Notification test and history errors [`InvalidEndDateError`](/documentation/AppStoreServerAPI/InvalidEndDateError) An error that indicates the end date is invalid. [`InvalidNotificationTypeError`](/documentation/AppStoreServerAPI/InvalidNotificationTypeError) An error that indicates the notification type or subtype is invalid. [`InvalidPaginationTokenError`](/documentation/AppStoreServerAPI/InvalidPaginationTokenError) An error that indicates the pagination token is invalid. [`InvalidStartDateError`](/documentation/AppStoreServerAPI/InvalidStartDateError) An error that indicates the start date is invalid. [`InvalidTestNotificationTokenError`](/documentation/AppStoreServerAPI/InvalidTestNotificationTokenError) An error that indicates the test notification token is invalid. [`InvalidInAppOwnershipTypeError`](/documentation/AppStoreServerAPI/InvalidInAppOwnershipTypeError) An error that indicates an invalid in-app ownership type parameter. [`InvalidProductIdError`](/documentation/AppStoreServerAPI/InvalidProductIdError) An error that indicates the product ID parameter is invalid. [`InvalidProductTypeError`](/documentation/AppStoreServerAPI/InvalidProductTypeError) An error that indicates the product type parameter is invalid. [`InvalidSortError`](/documentation/AppStoreServerAPI/InvalidSortError) An error that indicates the sort parameter is invalid. [`InvalidSubscriptionGroupIdentifierError`](/documentation/AppStoreServerAPI/InvalidSubscriptionGroupIdentifierError) An error that indicates the subscription group identifier is invalid. [`MultipleFiltersSuppliedError`](/documentation/AppStoreServerAPI/MultipleFiltersSuppliedError) An error that indicates the request is invalid because it has too many applied constraints. [`PaginationTokenExpiredError`](/documentation/AppStoreServerAPI/PaginationTokenExpiredError) An error that indicates the pagination token expired. [`ServerNotificationURLNotFoundError`](/documentation/AppStoreServerAPI/ServerNotificationURLNotFoundError) An error that indicates the App Store server couldn’t find a notifications URL for your app in the environment. [`StartDateAfterEndDateError`](/documentation/AppStoreServerAPI/StartDateAfterEndDateError) An error that indicates the end date precedes the start date, or the two dates are equal. [`StartDateTooFarInPastError`](/documentation/AppStoreServerAPI/StartDateTooFarInPastError) An error that indicates the start date is earlier than the earliest allowed date. [`TestNotificationNotFoundError`](/documentation/AppStoreServerAPI/TestNotificationNotFoundError) An error that indicates the test notification token is expired or the test notification status isn’t available. [`InvalidExcludeRevokedError`](/documentation/AppStoreServerAPI/InvalidExcludeRevokedError) An error that indicates the query parameter exclude-revoked is invalid. --- Copyright © 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)