# Billing Grace Periods Get information about the grace period and modify the opt-in value. ## Topics ### Endpoints [`Read the billing grace period value for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-subscriptionGracePeriod) Get the Boolean value that represents the grace period opt-in state for your app. [`Get the subscription grace period ID for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-relationships-subscriptionGracePeriod) [`Read the billing grace period value`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionGracePeriods-_id_) Get the Boolean value that represents the billing grace period opt-in state and the duration of the billing grace period. [`Modify the billing grace period opt-in status and duration`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionGracePeriods-_id_) Change the Boolean value representing the billing grace period opt-in status. ### Object [`string SubscriptionGracePeriodDuration`](/documentation/AppStoreConnectAPI/SubscriptionGracePeriodDuration) A string that represents the grace period duration for a subscription. [`object SubscriptionGracePeriodResponse`](/documentation/AppStoreConnectAPI/SubscriptionGracePeriodResponse) A response containing a single grace period configuration for a subscription. [`object SubscriptionGracePeriod`](/documentation/AppStoreConnectAPI/SubscriptionGracePeriod) A grace period configuration for a subscription, allowing subscribers continued access while payment issues are resolved. [`object SubscriptionGracePeriodUpdateRequest`](/documentation/AppStoreConnectAPI/SubscriptionGracePeriodUpdateRequest) The request body you use to update a subscription grace period update request. [`object AppSubscriptionGracePeriodLinkageResponse`](/documentation/AppStoreConnectAPI/AppSubscriptionGracePeriodLinkageResponse) --- 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)