App Infos
Read the age-rating declaration
Read age rating declaration information as a flat JSON object.
/apps/{appId}/app-infos/{appInfoId}/age-ratingImplemented · First release · Operator configuration and deployment required
Request
Routes are relative to your connection. Use a facade API key; the service manages Apple authentication.
BASE='https://asc.example.com/v1/connections/conn_example'
curl --fail-with-body "$BASE/apps/1234567890/app-infos/app_info_123/age-rating" \
-H "Authorization: Bearer $ASC_FACADE_KEY"const base = "https://asc.example.com/v1/connections/conn_example";
const response = await fetch(`${base}/apps/1234567890/app-infos/app_info_123/age-rating`, {
headers: { Authorization: `Bearer ${process.env.ASC_FACADE_KEY}` }
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.message ?? `HTTP ${response.status}`);
}
console.log(body);import json
import os
from urllib.request import Request, urlopen
from urllib.error import HTTPError
base = "https://asc.example.com/v1/connections/conn_example"
request = Request(
f"{base}/apps/1234567890/app-infos/app_info_123/age-rating",
headers={"Authorization": f"Bearer {os.environ['ASC_FACADE_KEY']}"},
)
try:
with urlopen(request) as response:
print(json.load(response))
except HTTPError as error:
detail = json.load(error)
raise RuntimeError(detail["error"]["message"]) from errorasc.example.com is a placeholder for your deployment. Examples use fictional IDs.
Path parameters
| Name | Type | Description |
|---|---|---|
| appId | string | Apple’s app ID. Returned by List apps. |
| appInfoId | string | An explicit app-info ID belonging to this app. |
Query parameters
| Name | Type | Description |
|---|---|---|
| fields | string | Comma-separated attribute names to return. This selects read fields and does not expand relationships. Multiple values are comma-separated.Valuesadvertising, alcoholTobaccoOrDrugUseOrReferences, contests, gambling, gamblingSimulated, gunsOrOtherWeapons, healthOrWellnessTopics, kidsAgeBand, lootBox, medicalOrTreatmentInformation, messagingAndChat, parentalControls, profanityOrCrudeHumor, ageAssurance, sexualContentGraphicAndNudity, sexualContentOrNudity, socialMedia, socialMediaAgeRestricted, horrorOrFearThemes, matureOrSuggestiveThemes, unrestrictedWebAccess, userGeneratedContent, violenceCartoonOrFantasy, violenceRealisticProlongedGraphicOrSadistic, violenceRealistic, ageRatingOverrideV2, koreaAgeRatingOverride, gracRatingClassificationNumber, developerAgeRatingInfoUrl |
Response
One flat object for the selected resource.
{
"id": "age_rating_declaration_123",
"appId": "1234567890",
"appInfoId": "app_info_123",
"advertising": false,
"alcoholTobaccoOrDrugUseOrReferences": "NONE",
"contests": "NONE"
}Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.
Response fields
| Name | Type | Description |
|---|---|---|
| id | string | Apple’s resource ID. Keep this string unchanged when addressing a resource. |
| appId | string | The app that owns this resource. |
| appInfoId | string | The selected app-info resource. |
| advertising | boolean | null | Whether Apple marks this resource as advertising. |
| alcoholTobaccoOrDrugUseOrReferences | string | null | The alcohol tobacco or drug use or references value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| contests | string | null | The contests value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| gambling | boolean | null | Whether Apple marks this resource as gambling. |
| gamblingSimulated | string | null | The gambling simulated value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| gunsOrOtherWeapons | string | null | The guns or other weapons value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| healthOrWellnessTopics | boolean | null | Whether Apple marks this resource as health or wellness topics. |
| kidsAgeBand | string | null | The kids age band value reported by Apple for this resource.ValuesFIVE_AND_UNDER, SIX_TO_EIGHT, NINE_TO_ELEVEN |
| lootBox | boolean | null | Whether Apple marks this resource as loot box. |
| medicalOrTreatmentInformation | string | null | The medical or treatment information value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| messagingAndChat | boolean | null | Whether Apple marks this resource as messaging and chat. |
| parentalControls | boolean | null | Whether Apple marks this resource as parental controls. |
| profanityOrCrudeHumor | string | null | The profanity or crude humor value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| ageAssurance | boolean | null | Whether Apple marks this resource as age assurance. |
| sexualContentGraphicAndNudity | string | null | The sexual content graphic and nudity value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| sexualContentOrNudity | string | null | The sexual content or nudity value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| socialMedia | boolean | null | Whether Apple marks this resource as social media. |
| socialMediaAgeRestricted | boolean | null | Whether Apple marks this resource as social media age restricted. |
| horrorOrFearThemes | string | null | The horror or fear themes value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| matureOrSuggestiveThemes | string | null | The mature or suggestive themes value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| unrestrictedWebAccess | boolean | null | Whether Apple marks this resource as unrestricted web access. |
| userGeneratedContent | boolean | null | Whether Apple marks this resource as user generated content. |
| violenceCartoonOrFantasy | string | null | The violence cartoon or fantasy value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| violenceRealisticProlongedGraphicOrSadistic | string | null | The violence realistic prolonged graphic or sadistic value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| violenceRealistic | string | null | The violence realistic value reported by Apple for this resource.ValuesNONE, INFREQUENT_OR_MILD, FREQUENT_OR_INTENSE, INFREQUENT, FREQUENT |
| ageRatingOverrideV2 | string | null | The age rating override v2 value reported by Apple for this resource.ValuesNONE, NINE_PLUS, THIRTEEN_PLUS, SIXTEEN_PLUS, EIGHTEEN_PLUS, UNRATED |
| koreaAgeRatingOverride | string | null | The korea age rating override value reported by Apple for this resource.ValuesNONE, ALL, TWELVE_PLUS, FIFTEEN_PLUS, NINETEEN_PLUS |
| gracRatingClassificationNumber | string | null | The grac rating classification number value reported by Apple for this resource. |
| developerAgeRatingInfoUrl | string · uri | null | The developer age rating info url URL reported by Apple. |
Behavior
- A nested resource must belong to the selected parent and the configured connection. The adapter validates ownership before returning data.
Errors
| HTTP | Type | Description |
|---|---|---|
| 400 | invalid_query | Unsupported filter, sort, limit, or cursor. |
| 401 | unauthorized | Missing or invalid facade API key. |
| 403 | forbidden / upstream_forbidden | The caller or configured Apple key cannot read this resource. |
| 404 | resource_not_found | The requested resource, parent, or exact locale is absent or outside the caller’s scope. |
| 429 | rate_limited | A facade or Apple rate limit was reached. Respect Retry-After when returned. |
| 502–504 | upstream error | Apple authentication, response parsing, availability, or timeout failure; this is not an empty result. |
Apple mapping
Upstream route and translation
The adapter calls GET /v1/appInfos/{id}/ageRatingDeclaration. Read Apple’s original endpoint ↗
Flatten Apple’s attributes into each resource object. Expose supplied singleton linkage as IDs, with no automatic relationship traversal. Read access does not make these fields writable.
| Facade parameter | Type | Description |
|---|---|---|
| fields | query | fields[ageRatingDeclarations] |
Reviewed 2026-10-14 · OpenAPI 4.5.1