Check age category
Resolves a player's age category for their jurisdiction from a date of birth or age, without creating a session or challenge. Use it when you need the category alone — to branch product behaviour, for example — rather than a full age gate decision.
Authorization
api-key In: header
Request Body
application/json
Check age category request
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/age-gate/check-age-category" \ -H "Content-Type: application/json" \ -d '{ "jurisdiction": "US-CA" }'{ "ageCategory": "digital-minor"}{ "error": "INVALID_INPUT", "errorMessage": "Invalid jurisdiction"}Rate limits
Previous Page
Check age gate POST
Runs an age gate check and decides whether a player may enter the game, creating an age challenge when one is needed. Supply the player's jurisdiction with exactly one age signal — `dateOfBirth`, `age`, or `kuid`. Passing none, or more than one, is a bad request. With `kuid`, the age already recorded by the player's guardian is used and the resulting session or challenge is tied to that user. The response `status` tells you what to do next: `PASS` returns a session and the player continues, `CHALLENGE` returns a challenge to complete first, and `PROHIBITED` returns neither because the player is below the product's minimum age. A one-time password on a returned challenge expires. Call `/challenge/generate-otp` when you are ready to display it, and regenerate it periodically until the challenge is in progress.