Guide
Implementing the User Age Group API
In partnership with 
2 min read
Share this doc:
If your app is intended for mixed ages (children aged 10-12 and teens and adults aged 13+), you are required to implement a User Age Group API.
Level of effort:
Skill Required:
Beginner to intermediate
Estimated Time to Implement:
2-4 hours
What is it?
Meta's User Age Group APIs allow you to either report your users' age group to Meta if you collect it yourself, or receive your users' age group from Meta.
You ARE required to...
Implement one of the Meta-provided APIs, either the Get Age Category or Report Age Category API, within 30 days of age group self-certification
You are NOT required to...
Undergo an additional review; Meta will confirm the data is flowing as expected, but will not conduct any additional review for this implementation
If you implement the Get Age Category API, it is your responsibility to make sure users are seeing content that is appropriate to their age group.
How long will it take?
Time required to implement and test will vary app-to-app, but we estimate it will only take you a few hours to complete. It will require a code integration, but you will not need to write any new, custom code. This implementation does not require advanced skills.
You can update your age group at any time as your app evolves. If your audience expands to include both teens and adults aged 13+ and children younger than 13, change your self-certified age group in the Developer Dashboard and complete this simple implementation within 30 days.
When should I make the API call?
Meta recommends you use the API once every session, i.e. every time a user enters the app.
Why am I required to implement this API?
Meta uses a variety of data points to estimate user age in case those users are an age different than stated in their account. If Meta believes that a user may not be in the right account for their age based on the signal received from a developer, then Meta will help the user migrate to the correct age appropriate account.
This integration does NOT give Meta access to any new data. It only facilitates the passing of user age group information to and from Meta to detect discrepancies.
Documentation:
Unity
UnrealFor more on this topic, take the course:
Completing Age Group Self-Certification
In this course, you will learn about the requirement to self-certify which age group your app is intended for and the corresponding requirements that will help keep your users safe.