<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/age-ratings",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Age Ratings"
}
-->

# Age Ratings

Read and update age ratings and declarations for your app.

## Discussion

`ageRatingDeclarations` handles your answers to the app-characteristic questions that affect your app’s age rating. This resource enables you to answer the questions and update your answers. You must fill out this information before submitting your app for review.

`territoryAgeRatings` allows you to read the age ratings per territory that are calculated by your age rating declaration responses.

For more information about age ratings, see [Set an app age rating](https://developer.apple.com/help/app-store-connect/manage-app-information/set-an-app-age-rating).

> Important: The age-rating declaration attributes `INFREQUENT_OR_MILD` and `FREQUENT_OR_INTENSE` are deprecated. Instead, use `INFREQUENT` or `FREQUENT`.

## Topics

### Reading and modifying declarations

[`Read the age-rating declaration`](/documentation/AppStoreConnectAPI/GET-v1-appInfos-_id_-ageRatingDeclaration)

Get the age-rating declaration for an app info.

[`Get the age rating declaration ID for an app info`](/documentation/AppStoreConnectAPI/GET-v1-appInfos-_id_-relationships-ageRatingDeclaration)

[`Modify an age rating declaration`](/documentation/AppStoreConnectAPI/PATCH-v1-ageRatingDeclarations-_id_)

Provide age-related information so the App Store can determine the age rating for your app.

### Reading territory age rating

[`List Territory Age Ratings for an App Info`](/documentation/AppStoreConnectAPI/GET-v1-appInfos-_id_-territoryAgeRatings)

List all territory age ratings for a specific app info.

[`List territory age rating IDs for an app info`](/documentation/AppStoreConnectAPI/GET-v1-appInfos-_id_-relationships-territoryAgeRatings)

List all territory age rating IDs for a specific app info.

### Objects and data types

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

A set of content descriptors for your app that App Store Connect uses to assign an age rating.

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

A response containing a single age rating declaration with your app’s content descriptors.

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

The request body you use to update an Age Rating Declaration.

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

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

A response containing the resource identifiers of territory-specific age ratings for an app info record.

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

A string that represents the app’s age rating as it appears on the App Store for all platforms.

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

String that represents the app’s age rating as it appears on the App Store in Brazil for all platforms.

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

String that represents the age band for a Made for Kids app.

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

The data structure that represent a territory age-rating resource.

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

A response containing a list of age ratings assigned to an app across App Store territories.


---

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)