Skip to main content

app.bsky.ageassurance.defs

#access​

PropertyTypeKnown ValuesRequiredDescription
accessstringunknown
none
safe
full
❌The access level granted based on Age Assurance data we've processed.

#status​

PropertyTypeKnown ValuesRequiredDescription
statusstringunknown
pending
assured
blocked
❌The status of the Age Assurance process.

#state​

The user's computed Age Assurance state.

PropertyTypeKnown ValuesRequiredDescription
lastInitiatedAtstring (datetime)-❌The timestamp when this state was last updated.
statusapp.bsky.ageassurance.defs#status-✅-
accessapp.bsky.ageassurance.defs#access-✅-

#stateMetadata​

Additional metadata needed to compute Age Assurance state client-side.

PropertyTypeKnown ValuesRequiredDescription
accountCreatedAtstring (datetime)-❌The account creation timestamp.

#config​

PropertyTypeKnown ValuesRequiredDescription
regionsarray of app.bsky.ageassurance.defs#configRegion-✅The per-region Age Assurance configuration.

#configRegion​

The Age Assurance configuration for a specific region.

PropertyTypeKnown ValuesRequiredDescription
platformsarray of string-❌The platforms this configuration applies to. If omitted, the configuration applies to all platforms.
countryCodestring-✅The ISO 3166-1 alpha-2 country code this configuration applies to.
regionCodestring-❌The ISO 3166-2 region code this configuration applies to. If omitted, the configuration applies to the entire country.
minAccessAgeinteger-✅The minimum age (as a whole integer) required to use Bluesky in this region.
additionalVerificationMethodsarray of string-❌Verification methods permitted in this region in addition to the third-party (KWS) flow, which is always supported. device permits using the native on-device age APIs (e.g. Apple Declared Age Range, Google Play Age Signals).
rulesarray of union
#configRegionRuleDefault
#configRegionRuleIfDeclaredOverAge
#configRegionRuleIfDeclaredUnderAge
#configRegionRuleIfAssuredOverAge
#configRegionRuleIfAssuredUnderAge
#configRegionRuleIfAccountNewerThan
#configRegionRuleIfAccountOlderThan
-✅The ordered list of Age Assurance rules that apply to this region. Rules should be applied in order, and the first matching rule determines the access level granted. The rules array should always include a default rule as the last item.

#configRegionRuleDefault​

Age Assurance rule that applies by default.

PropertyTypeKnown ValuesRequiredDescription
accessapp.bsky.ageassurance.defs#access-✅-

#configRegionRuleIfDeclaredOverAge​

Age Assurance rule that applies if the user has declared themselves equal-to or over a certain age.

PropertyTypeKnown ValuesRequiredDescription
ageinteger-✅The age threshold as a whole integer.
accessapp.bsky.ageassurance.defs#access-✅-

#configRegionRuleIfDeclaredUnderAge​

Age Assurance rule that applies if the user has declared themselves under a certain age.

PropertyTypeKnown ValuesRequiredDescription
ageinteger-✅The age threshold as a whole integer.
accessapp.bsky.ageassurance.defs#access-✅-

#configRegionRuleIfAssuredOverAge​

Age Assurance rule that applies if the user has been assured to be equal-to or over a certain age.

PropertyTypeKnown ValuesRequiredDescription
ageinteger-✅The age threshold as a whole integer.
accessapp.bsky.ageassurance.defs#access-✅-

#configRegionRuleIfAssuredUnderAge​

Age Assurance rule that applies if the user has been assured to be under a certain age.

PropertyTypeKnown ValuesRequiredDescription
ageinteger-✅The age threshold as a whole integer.
accessapp.bsky.ageassurance.defs#access-✅-

#configRegionRuleIfAccountNewerThan​

Age Assurance rule that applies if the account is equal-to or newer than a certain date.

PropertyTypeKnown ValuesRequiredDescription
datestring (datetime)-✅The date threshold as a datetime string.
accessapp.bsky.ageassurance.defs#access-✅-

#configRegionRuleIfAccountOlderThan​

Age Assurance rule that applies if the account is older than a certain date.

PropertyTypeKnown ValuesRequiredDescription
datestring (datetime)-✅The date threshold as a datetime string.
accessapp.bsky.ageassurance.defs#access-✅-

#event​

Object used to store Age Assurance data in stash.

PropertyTypeKnown ValuesRequiredDescription
createdAtstring (datetime)-✅The date and time of this write operation.
attemptIdstring-✅The unique identifier for this instance of the Age Assurance flow, in UUID format.
statusstringunknown
pending
assured
blocked
✅The status of the Age Assurance process.
accessstringunknown
none
safe
full
✅The access level granted based on Age Assurance data we've processed.
countryCodestring-✅The ISO 3166-1 alpha-2 country code provided when beginning the Age Assurance flow.
regionCodestring-❌The ISO 3166-2 region code provided when beginning the Age Assurance flow.
emailstring-❌The email used for Age Assurance.
initIpstring-❌The IP address used when initiating the Age Assurance flow.
initUastring-❌The user agent used when initiating the Age Assurance flow.
completeIpstring-❌The IP address used when completing the Age Assurance flow.
completeUastring-❌The user agent used when completing the Age Assurance flow.